Sandbox & akun developer

Mengapa memakai sandbox

• Tidak perlu paket Pro untuk token aplikasi maupun webhook aplikasi.
• Pesanan, produk, stok, kontak, dan chat contoh yang realistis sejak menit pertama; tidak perlu menghubungkan toko marketplace.
• Event webhook simulasi untuk menguji receiver Anda tanpa menunggu pesanan sungguhan.
• Uji aplikasi OAuth Anda dari awal sampai akhir sebelum mengajukannya untuk review.

Buat akun developer

Daftar dengan tipe akun developer. Gratis.

Di ruang kerja developer, akses API selalu lewat aplikasi OAuth: daftarkan aplikasi di Developer Console → Aplikasi, lalu tekan Buat token uji untuk mendapatkan access token.

Data contoh

Setiap akun developer sudah diisi dengan:

Yang diblokir

Akun developer tidak bisa membuat atau menghubungkan toko sungguhan, menghubungkan chat, mengganti paket, membayar tagihan, atau membeli kredit AI. Operasi tersebut dijawab 403 DEVELOPER_ACCOUNT_RESTRICTED. API key dan endpoint webhook manual juga tidak tersedia: akses API dan webhook selalu lewat aplikasi OAuth.

Sandbox mode

Sebuah request berjalan dalam sandbox mode bila memakai:

• token aplikasi apa pun yang terpasang di ruang kerja developer, atau
• token dari aplikasi yang belum dipublikasikan dan terpasang di tenant developernya sendiri. Ini berlaku di paket apa pun, termasuk akun merchant gratis.

• x-ratelimit-limit menunjukkan limit yang berlaku (60 atau 600).
• GET /v1/developer/token-info mengembalikan sandbox: true.

{
  "tenantId": "0192f0c0-1111-7aaa-8bbb-0123456789ab",
  "kind": "api_key",
  "scopes": [
    "orders:read"
  ],
  "sandbox": true
}

Uji aplikasi OAuth sebelum review

1. Daftarkan aplikasi di Developer Console → Aplikasi. Statusnya dimulai dari development.
2. Tekan Buat token uji untuk memasang aplikasi di ruang kerja ini dan langsung mendapat access token serta refresh token (POST /v1/developer/apps/{appId}/test-token). Untuk menguji alur lengkap, jalankan authorization flow sambil masuk ke ruang kerja yang sama.
3. Token yang Anda dapat berjalan dalam sandbox mode: tidak perlu Pro, 60 request/menit.
4. Setelah berfungsi, tekan Ajukan review.

Event simulasi

POST /v1/developer/sandbox/events mengantrekan event contoh dengan tipe yang diberikan (event webhook apa pun) ke setiap endpoint tenant yang berlangganan tipe tersebut, termasuk endpoint yang dikelola aplikasi. Di konsol, ini adalah tombol Kirim simulasi di Developer Console → Simulasi event. Event diterima oleh webhook aplikasi yang terpasang di ruang kerja ini.

curl -X POST "https://api.comnethub.app/v1/developer/sandbox/events" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "inventory.stock_changed"}'

{
  "eventId": "0192f0d0-aaaa-7bbb-8ccc-ddddeeeeffff",
  "deliveries": 2
}

deliveries adalah jumlah endpoint tujuan event diantrekan. Envelope-nya sama seperti biasa ditambah simulated: true, dan ditandatangani dengan header yang sama:

{
  "id": "0192f0d0-aaaa-7bbb-8ccc-ddddeeeeffff",
  "type": "inventory.stock_changed",
  "createdAt": "2026-11-04T07:12:31.204Z",
  "tenantId": "0192f0c0-1111-7aaa-8bbb-0123456789ab",
  "simulated": true,
  "data": {
    "itemId": "0192f0c8-5d6e-7f80-91a2-b3c4d5e6f708",
    "sku": "KAOS-M",
    "name": "Kaos Polos Katun M",
    "previousAvailable": 6,
    "available": 4,
    "reason": "order"
  }
}

Pindah ke produksi

• API key untuk bisnis Anda sendiri: buat di tenant merchant dengan paket Pro; key tersebut mendapat 600 request/menit.
• Aplikasi: setelah aplikasi dipublikasikan, instalasi mengikuti aturan normal. Merchant yang memasang butuh Pro, dan limitnya 600 request/menit per instalasi. Instalasi di tenant milik sendiri juga keluar dari sandbox mode, kecuali tenant itu akun developer.
• Hapus penanganan yang bergantung pada data contoh, dan tetap abaikan event simulated: true.