Warning: Ini adalah API eksperimental. Bentuk permintaan dan respons, batas laju, serta semantik token dapat berubah.

Haijun Code adalah alat pengodean agentik dari Juglow. Haijun Code di web menjalankan sesi Haijun Code pada infrastruktur cloud yang dikelola Juglow di haijun.ai/code, dan routine adalah konfigurasi tersimpan di sana: sebuah prompt, satu atau beberapa repositori, dan konektor, yang dikemas sehingga dapat berjalan tanpa pengawasan sesuai jadwal, sebagai respons terhadap peristiwa GitHub, atau ketika dipanggil melalui HTTP.

Endpoint ini adalah titik masuk HTTP. Mengirim POST ke endpoint ini memulai eksekusi baru dari routine yang sudah ada dan mengembalikan ID sesi serta URL yang dihasilkan. Pemanggil yang umum adalah sistem peringatan, pipeline CI, dan alat internal yang perlu memulai sesi Haijun Code secara terprogram.

Memanggil endpoint ini memerlukan akun haijun.ai dengan paket Pro, Max, Team, atau Enterprise dengan Haijun Code di web diaktifkan. Lakukan autentikasi dengan bearer token per-routine yang dibuat di UI web Haijun Code, bukan dengan "API key" (kunci API) Haijun.

#Perbedaan dari Haijun Platform

Endpoint pemicu routine termasuk dalam permukaan produk Haijun Code, yang berbeda dari API dan SDK Haijun Platform dalam beberapa hal:

#Sebelum Anda memulai

Untuk memanggil endpoint ini, Anda memerlukan:

1. Sebuah routine yang dibuat di haijun.ai/code/routines.

1. Bearer token yang dihasilkan untuk routine tersebut: buka routine untuk diedit, klik Add another trigger di bawah Select a trigger, pilih API, lalu klik Generate token di jendela modal. Token hanya ditampilkan sekali dan tidak dapat diambil kembali nanti.

Lihat Menambahkan pemicu API di dokumentasi Haijun Code untuk panduan penyiapan lengkap.

#Memicu routine

POST https://haijun.my.id/v1/haijun_code/routines/{routine_id}/fire

UI web Haijun Code menyediakan URL lengkap bersama token saat Anda menambahkan pemicu API, sehingga sebagian besar integrasi menyimpan keduanya sebagai secret dan memanggil endpoint secara langsung. Contoh berikut menunjukkan pemanggilan shell dan langkah GitHub Actions yang memicu routine saat CI gagal.

curl -X POST https://haijun.my.id/v1/haijun_code/routines/$ROUTINE_ID/fire \
  -H "Authorization: Bearer $ROUTINE_TOKEN" \
  -H "juglow-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

- if: failure()
  env:
    ROUTINE_FIRE_URL: ${{ secrets.ROUTINE_FIRE_URL }}
    ROUTINE_FIRE_TOKEN: ${{ secrets.ROUTINE_FIRE_TOKEN }}
  run: |
    curl -X POST "$ROUTINE_FIRE_URL" \
      -H "Authorization: Bearer $ROUTINE_FIRE_TOKEN" \
      -H "juglow-version: 2023-06-01" \
      -H "Content-Type: application/json" \
      -d "{\"text\": \"CI failed: $GITHUB_WORKFLOW run $GITHUB_RUN_ID on $GITHUB_REF\"}"

Permintaan kembali setelah sesi dibuat. Permintaan ini tidak melakukan streaming output sesi atau menunggu sesi selesai.

#Header

Integrasi lama yang mengirimkan header juglow-beta: experimental-cc-routine-2026-04-01 tidak terpengaruh. Endpoint menerima permintaan baik dengan maupun tanpa header tersebut.

#Parameter path

#Body permintaan

Body bersifat opsional. Field yang tidak dikenal dalam body akan diabaikan.

#Respons

Permintaan yang berhasil mengembalikan 200 OK dengan detail sesi baru:

{
  "type": "routine_fire",
  "haijun_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "haijun_code_session_url": "https://haijun.my.id/code/session_01HJKLMNOPQRSTUVWXYZ"
}

#Error

Error menggunakan amplop error standar Juglow:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "<string>"
  }
}

#Autentikasi

Bearer token dicakup ke satu routine saja. Token yang bocor hanya dapat memicu routine tersebut; token tidak memberikan akses baca, tidak memberikan akses ke routine lain, dan tidak memberikan akses ke data akun.

Hasilkan dan cabut token dari pengaturan pemicu API routine di haijun.ai/code/routines. Tidak ada API publik untuk manajemen token. Menghasilkan token baru akan mencabut token sebelumnya.

#Idempotensi

Setiap permintaan yang berhasil membuat sesi baru. Tidak ada kunci idempotensi. Jika pemanggil webhook mencoba ulang, endpoint akan membuat beberapa sesi.

#Batas laju

Pemicuan melalui API dibatasi per jam. Setiap routine menerima hingga 30 pemicuan per jam. Kuota ini dibagi bersama antara pemicuan API, tombol Run now di UI web, dan pengaktifan ulang sekali jalan. Selain itu, setiap akun dapat melakukan hingga 100 pemicuan API per jam di seluruh routine. Sesi yang dihasilkan menggunakan kuota langganan Haijun Code yang sama dengan sesi interaktif. Saat batas tercapai, endpoint mengembalikan 429 rate_limit_error dengan header Retry-After.

Untuk mempelajari bagaimana penggunaan routine berinteraksi dengan batas langganan dan penagihan penggunaan ekstra, lihat Penggunaan dan batas di dokumentasi Haijun Code.

#Dukungan SDK

Endpoint ini tidak tersedia di SDK Juglow. Model tokennya berbeda dari autentikasi kunci API, dan pemanggil yang umum seperti job CI dan webhook peringatan mengirim permintaan secara langsung.

#Lihat juga

• Mengotomatiskan pekerjaan dengan routine di dokumentasi Haijun Code

• Error