Task Dispatch API

Kirim pekerjaan ke Koding Studio (TEFA). Berbeda dari AI gateway /api/v1/generate. Mahasiswa mengerjakan di koding.studio.

Endpoint

POST https://code.adolo.id/api/jobs
# alias: https://koding.studio/api/jobs

Auth

Header x-api-key — nilai dari env frontend KS:

ADOLO_API_KEY → source adolo
JASAPROMO_API_KEY → jasapromo
ENGINE_API_KEY (fallback) → jasapromo

Request body

{
  "orderCode": "ADO-2026-001",
  "service": "Landing UMKM",
  "category": "WEBSITE",
  "tier": "starter",
  "instruction": "Bangun landing sesuai brief",
  "brief": "Toko roti, CTA WhatsApp",
  "client": { "name": "Bu Sari", "phone": "0812…", "company": "Roti Sari" },
  "callbackUrl": "https://adolo.id/apps/…/webhook",
  "agency": "UNMAHA TEFA"
}

Wajib: orderCode, service, category. agency opsional (default TEFA_AGENCY di backend).

Response

201 baru · 200 idempotent (orderCode + source sama).

{
  "jobId": "ks-42",
  "playbook": { "id": 1, "slug": "…", "title": "…" },
  "projectId": 42,
  "externalRef": "ADO-2026-001",
  "status": "OPEN",
  "idempotent": false
}

Callback ke app Anda

KS POST ke callbackUrl (header x-api-key: ENGINE_API_KEYbila di-set):

{
  "status": "COMPLETED",
  "externalRef": "ADO-2026-001",
  "projectId": 42,
  "resultUrl": "https://koding.studio/?project=42",
  "resultLabel": "Hasil pekerjaan",
  "message": "…"
}

status	Kapan
ACCEPTED	Order diterima (OPEN)
IN_PROGRESS	Mahasiswa claim
REVIEW	Submit mentor
NEEDS_REVISION	Mentor reject
COMPLETED	Mentor approve

Kategori umum

WEBSITE · APPS · SETUP_AUTOCHAT · KONTEN · DESAIN — lihat juga alias jasapromo di kode jobs-intake.ts.

Error

401 — x-api-key tidak dikenal
422 — field wajib kurang
502/503 — gateway / INTERNAL_API_KEY

Runbook domain: docs/DOMAIN_CODE_ADOLO.md di repo · Integrasi lengkap: docs/integration-guide.md