Sumber daya

Changelog

Perubahan pada API publik dan webhook.

Developer Console terpisah; aplikasi OAuth khusus ruang kerja developer

2026-11-05

Aplikasi, API key sandbox, dan webhook sandbox dikelola di Developer Console (/console di situs developer). Satu login TheComNet bisa punya bisnis dan ruang kerja developer terpisah.
POST /v1/developer/apps dan POST /v1/developer/apps/{id}/submit dari ruang kerja penjual dijawab 403 DEVELOPER_ACCOUNT_REQUIRED.
Penjual mengelola API key, webhook, dan aplikasi terpasang di Pengaturan → Integrasi.
Ruang kerja developer mengakses API hanya lewat aplikasi OAuth: API key dan endpoint webhook manual dijawab 403 DEVELOPER_ACCOUNT_RESTRICTED. Baru: POST /v1/developer/apps/{id}/test-token memasang aplikasi di sandbox dan mengeluarkan token tanpa alur redirect.

2026-11-04

Akun developer gratis berisi toko contoh, produk, stok, pesanan, kontak, dan chat. Operasi toko, paket, dan tagihan dijawab 403 DEVELOPER_ACCOUNT_RESTRICTED. Lihat Sandbox & akun developer.
Sandbox mode untuk akun developer dan untuk aplikasi yang belum dipublikasikan di tenant miliknya sendiri: tidak perlu Pro, 60 request per menit, token-info melaporkan sandbox: true.
POST /v1/developer/sandbox/events mengirim event contoh dengan simulated: true ke endpoint yang berlangganan.

2026-11-04

Daftarkan aplikasi di Developer Console → Aplikasi (tcn_app_… / tcn_cs_…), ajukan review, dan publikasikan ke semua tenant. Lihat Membuat aplikasi (OAuth 2.0).
POST /v1/oauth/token menerbitkan access token 1 jam (tcn_at_…) dan refresh token 90 hari (tcn_rt_…) yang berotasi saat dipakai; POST /v1/oauth/revoke mengikuti RFC 7009.
App token memakai endpoint dan scope API key, dibatasi 600 request per menit per instalasi. token-info melaporkan kind: "app".
Webhook aplikasi: satu URL dan secret per aplikasi, satu endpoint per instalasi.

2026-11-04

API key (tcn_live_…) untuk tenant Pro, dibuat di Pengaturan → Developer. Lihat Autentikasi.
Delapan scope untuk pesanan, produk, kontak, dan chat; setiap operasi memilih scope-nya sendiri. Lihat referensi API.
600 request per menit per key dengan header x-ratelimit-*.
Webhook bertanda tangan untuk pesanan, after-sales, stok, dan chat. Lihat Webhook.