AgenWebsite Rate API

REST API cek ongkir Indonesia untuk developer — J&T, Lion, SAP, SPX, J&T Cargo dalam satu endpoint.

Versi 1.0 Update terakhir: Juli 2026 9 Artikel

Riwayat Versi

Ringkasan

Halaman ini mencatat perubahan pada AgenWebsite Rate API. API menggunakan versioning lewat prefix path (/v1). Perubahan yang tidak merusak kompatibilitas (menambah field baru pada response) dapat terjadi kapan saja pada v1 — pastikan integrasi Anda mengabaikan field yang belum dikenal.

Ikuti prinsip tolerant reader: jangan gagal saat menemukan field baru pada response, dan jangan bergantung pada urutan properti JSON.

v1.0 — Rilis Perdana (Juli 2026)

Rilis publik pertama AgenWebsite Rate API. Mencakup empat endpoint inti dengan autentikasi x-api-key, kuota harian per paket (Free / Pro / Max), dan tarif ter-branding untuk semua kurir yang didukung AgenWebsite.

Area Detail
Endpoint POST /v1/rates, GET /v1/couriers, GET /v1/locations/search, GET /v1/usage
Kurir Semua kurir yang didukung AgenWebsite
Cakupan Khusus cek ongkos kirim (menghitung tarif) — tidak membuat order maupun AWB, dan tidak menangani COD/checkout
Kuota Harian per-user — Free 150 · Pro 30.000 · Max 60.000 (reset 00:00 WIB)
Fitur tarif Diskon & cashback riil, penanda termurah/tercepat, estimasi tanggal tiba, asuransi, logo kurir

Ringkasan Rilis · v1.0

{
  "version": "1.0.0",
  "released_at": "2026-07",
  "endpoints": [
    "POST /v1/rates",
    "GET  /v1/couriers",
    "GET  /v1/locations/search",
    "GET  /v1/usage"
  ],
  "couriers": ["jnt", "lion", "sap", "spx", "jtc"],
  "scope": "shipping rates only (no order/AWB/COD)"
}

Roadmap

Fitur berikut sedang direncanakan untuk rilis mendatang. Belum tersedia di v1 dan dapat berubah:

Fitur Status Catatan
COD (Cash on Delivery) Roadmap Perhitungan ongkir & biaya COD. Field cod_supported disiapkan namun kini selalu false.
Pelacakan AWB / resi Roadmap Cek status & riwayat perjalanan paket berdasarkan nomor resi.
Layanan express / same-day Dipertimbangkan Dukungan tarif untuk layanan express/same-day belum tersedia di v1.
Kurir tambahan Dipertimbangkan Menambah lebih banyak kurir yang didukung.
COD & AWB ada di roadmap. Ingin diberi tahu saat rilis? Hubungi tim di admin@adops.id. Setiap penambahan hanya berupa field/endpoint baru sehingga integrasi v1 Anda tetap kompatibel.
1

Memulai / Quickstart

Dapatkan API key, kirim request cek ongkir pertama, dan pahami struktur respons dalam beberapa menit.

Baca Artikel
2

Autentikasi (x-api-key)

Cara mengautentikasi request dengan header x-api-key, format key awk_live_, serta praktik keamanan, rotasi, dan revoke.

Baca Artikel
3

Batas & Kuota (Rate Limits)

Kuota harian per tier Free/Pro/Max, batas burst per menit, header X-RateLimit-*, respons 429, dan praktik terbaik.

Baca Artikel
4

Penanganan Error

Envelope error standar, tabel lengkap semua kode HTTP (400/401/404/422/429/502), dan contoh respons untuk tiap kasus.

Baca Artikel
5

POST /v1/rates — Cek Ongkir

Endpoint utama cek ongkir: request body lengkap, contoh curl, response ter-branding penuh dengan penjelasan tiap field, helper termurah/tercepat.

Baca Artikel
6

GET /v1/couriers

Daftar kurir yang didukung: contoh response dan tabel pemetaan courier_code ke nama kurir (J&T, Lion, SAP, SPX, J&T...

Baca Artikel
7

GET /v1/locations/search

Autocomplete kecamatan & kode pos: query param, contoh response, dan cara mengumpankan subdistrict_id / postal_code ke /v1/rates.

Baca Artikel
8

GET /v1/usage

Pantau kuota harian: window saat ini, contoh response, dan cara memantau sisa kuota via header X-RateLimit tanpa panggilan...

Baca Artikel
9

Changelog

Riwayat versi API: rilis perdana v1.0 (Juli 2026) dengan rates/couriers/locations/usage, plus roadmap COD & pelacakan AWB.

Baca Artikel