Dokumentasi API
Lacak resi dari aplikasimu lewat satu endpoint sederhana.
Akses API memerlukan API key berbayar.Beli API key
Autentikasi
Kirim API key lewat header x-api-key, atau parameter apikey di URL.
Lacak resi
GET /v1/track
| Parameter | Keterangan |
|---|---|
resi | Nomor resi. Wajib. |
courier | Kode kurir. Opsional, dideteksi otomatis bila memungkinkan. |
hp | 5 digit terakhir nomor HP penerima. Opsional, dibutuhkan beberapa kurir. |
Contoh permintaan
curl "/v1/track?resi=SPXID012345678901" \ -H "x-api-key: ck_xxxxxxxx"
const r = await fetch("/v1/track?resi=SPXID012345678901", {
headers: { "x-api-key": "ck_xxxxxxxx" }
});
console.log(await r.json());
import requests
r = requests.get(
"/v1/track",
params={"resi": "SPXID012345678901"},
headers={"x-api-key": "ck_xxxxxxxx"},
)
print(r.json())
Contoh respons
{
"status": true,
"resi": "SPXID012345678901",
"courier": "SPX Express",
"delivery_status": "Terkirim",
"info": { "Tujuan": "Jakarta" },
"last_update": { "date": "30/10/2026 14:20", "description": "Paket diterima" },
"history": [
{ "date": "30/10/2026 14:20", "description": "Paket diterima" }
]
}
Jika kurir belum terdeteksi, respons berisi need_courier: true dan daftar options. Jika kurir meminta nomor HP, respons berisi need_hp: true.
Kuota dan header
Setiap permintaan mengurangi kuota bulanan. Sisa kuota dikirim lewat header X-Quota-Limit dan X-Quota-Remaining.
Kode error
| Kode | Arti |
|---|---|
400 | Nomor resi tidak valid. |
401 | API key tidak ada atau tidak valid. |
402 | Langganan sudah kedaluwarsa. |
429 | Kuota bulan ini habis. |