Panduan lengkap

AgenWebsite Rate API

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

  • 9 artikel
  • 3 bab
  • ± 17 menit baca
  • Diperbarui 2 Jul 2026

Mencari judul, ringkasan, dan nama bagian di setiap artikel.

Baru memasang?

Mulai dari sini

3 langkah untuk membuat plugin siap dipakai, sesuai urutan.

  1. 1 Request pertama Memulai / Quickstart · 1 menit
  2. 2 Pasang API key Autentikasi (x-api-key) · 2 menit
  3. 3 Cek ongkir POST /v1/rates — Cek Ongkir · 5 menit
Jawaban cepat

Yang paling sering dicari

Langsung ke bagian artikel yang menjawabnya.

Ikhtisar

Tentang Rate API

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.
Bab 1

Memulai

Kirim request pertama, pasang header x-api-key, dan pahami kuota harian serta batas per menit.

3 artikel
  1. 01 Memulai / Quickstart Dapatkan API key, kirim request cek ongkir pertama, dan pahami struktur respons dalam beberapa menit. 1 menit baca 3 bagian
    Lihat isi (3 bagian)
  2. 02 Autentikasi (x-api-key) Cara mengautentikasi request dengan header x-api-key, format key awk_live_, serta praktik keamanan, rotasi, dan revoke. 2 menit baca 4 bagian
    Lihat isi (4 bagian)
  3. 03 Batas & Kuota (Rate Limits) Kuota harian per tier Free/Pro/Max, batas burst per menit, header X-RateLimit-*, respons 429, dan praktik terbaik. 2 menit baca 4 bagian
    Lihat isi (4 bagian)
Bab 2

Endpoint

Cek ongkir, daftar kurir, pencarian kecamatan dan kode pos, serta pemakaian kuota.

4 artikel
  1. 04 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. 5 menit baca 7 bagian
    Lihat isi (7 bagian)
  2. 05 GET /v1/couriers Daftar kurir yang didukung: contoh response dan tabel pemetaan courier_code ke nama kurir (J&T, Lion, SAP, SPX, J&T Cargo). 1 menit baca 5 bagian
    Lihat isi (5 bagian)
  3. 06 GET /v1/locations/search Autocomplete kecamatan & kode pos: query param, contoh response, dan cara mengumpankan subdistrict_id / postal_code ke /v1/rates. 2 menit baca 6 bagian
    Lihat isi (6 bagian)
  4. 07 GET /v1/usage Pantau kuota harian: window saat ini, contoh response, dan cara memantau sisa kuota via header X-RateLimit tanpa panggilan ekstra. 1 menit baca 5 bagian
    Lihat isi (5 bagian)
Bab 3

Referensi

Kode error dan cara menanganinya, serta riwayat perubahan API.

2 artikel
  1. 08 Penanganan Error Envelope error standar, tabel lengkap semua kode HTTP (400/401/404/422/429/502), dan contoh respons untuk tiap kasus. 2 menit baca 3 bagian
    Lihat isi (3 bagian)
  2. 09 Changelog Riwayat versi API: rilis perdana v1.0 (Juli 2026) dengan rates/couriers/locations/usage, plus roadmap COD & pelacakan AWB. 1 menit baca 3 bagian
    Lihat isi (3 bagian)
Masih butuh bantuan?

Belum ketemu jawabannya?

Tanyakan ke asisten AI kami soal pengaturan plugin, error, lisensi, atau saldo: dijawab langsung. Kalau masih buntu, tim support siap membantu lewat WhatsApp.

Chat tim support

Atau lewat halaman kontak.