Quickstart

Alur lengkap dari nol sampai order pertama selesai. Contoh memakai curl; versi TypeScript dan Python ada di Contoh kode.

1. Akses organisasi#

Masuk ke dashboard di https://app.dampingin.com/organisasi, buat organisasi, lalu isi pengajuan (perusahaan, situs, use case, perkiraan volume). Tim Dampingin meninjau pengajuan. Selama status organisasi belum disetujui, API key belum bisa dibuat.

2. Buat API key#

Di halaman organisasi, bagian API key agent, isi nama key, batas per order, batas per bulan, webhook (opsional), dan scope. Hanya owner dan admin organisasi yang bisa membuat atau mencabut key. Key hanya ditampilkan sekali, bentuknya:

dk_live_<prefix>.<secret>

Simpan di secret manager atau variabel lingkungan, jangan di kode. Detail scope dan batas ada di Autentikasi.

3. Isi deposit#

Order agent dibayar dari deposit organisasi. Saat ini deposit diisi lewat transfer dengan ID organisasi (org_...) di berita transfer; tim Finance mengonfirmasi dan saldo bertambah. Cek saldo kapan saja dengan GET /v1/balance.

4. Baca katalog#

export DAMPINGIN_API_KEY="dk_live_xxxxxx.rahasia"

curl https://api.dampingin.com/v1/services \
  -H "Authorization: Bearer $DAMPINGIN_API_KEY"

Setiap layanan membawa price_idr (harga agent), SLA, dan intake: daftar field yang harus diisi saat order.

5. Buat order#

curl -X POST https://api.dampingin.com/v1/orders \
  -H "Authorization: Bearer $DAMPINGIN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5b8e0c1a-7f7e-4b61-9a53-3c1f0f1d2e11" \
  -d '{
    "service": "pt-perorangan",
    "intake": {
      "nama_pt": "PT Maju Jaya, PT Maju Jaya Abadi, PT Maju Bersama",
      "kbli": "62019",
      "pemilik": "Budi Santoso"
    },
    "max_budget": 3000000,
    "callback_url": "https://agent.example.com/hooks/dampingin"
  }'

Respons 201. Kalau harga di bawah ambang persetujuan organisasi dan deposit cukup, order langsung dibayar:

{
  "id": "ord_xxxxxxxxxxxxxxxxxxxx",
  "service": "pt-perorangan",
  "status": "dibayar",
  "price_idr": 2900000,
  "max_budget": 3000000,
  "intake": { "nama_pt": "PT Maju Jaya, ...", "kbli": "62019", "pemilik": "Budi Santoso" },
  "callback_url": "https://agent.example.com/hooks/dampingin",
  "sla_due_at": "2026-10-04T08:00:00.000Z",
  "deliverable": null,
  "approval_required": false,
  "messages": [],
  "created_at": "2026-09-27T08:00:00.000Z",
  "updated_at": "2026-09-27T08:00:00.000Z"
}

Kalau harga di atas ambang, status menunggu_bayar dengan approval_required: true; admin organisasi menyetujui di dashboard.

6. Pantau dan terima hasil#

Tunggu webhook (lihat Webhooks) atau polling:

curl https://api.dampingin.com/v1/orders/ord_xxxxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer $DAMPINGIN_API_KEY"

1. ditawarkan: order ditawarkan ke praktisi yang memenuhi syarat, satu per satu, masing-masing 30 menit.
2. diambil lalu dikerjakan: praktisi bekerja.
3. butuh_input_klien: baca pesan terakhir dari praktisi di messages, balas dengan POST /v1/orders/{id}/messages.
4. diserahkan: hasil ada di deliverable. Periksa, lalu terima:

curl -X POST https://api.dampingin.com/v1/orders/ord_xxxxxxxxxxxxxxxxxxxx/accept \
  -H "Authorization: Bearer $DAMPINGIN_API_KEY"

Status menjadi selesai dan dana escrow dilepas ke praktisi.