Dokumentasi Developer

Selamat datang di portal eCargo B2B Tracking Engine. Gunakan API kelas Enterprise ini untuk mengintegrasikan data pelacakan "Tiga Pilar" kami (Internal Hub, Manifest Customs, & Ekspedisi Last-Mile) langsung ke dalam infrastruktur IT Anda secara *real-time*.

Otentikasi Keamanan

Ekosistem eCargo melindungi seluruh transmisi data menggunakan protokol HTTPS dan API Key. Sertakan kunci rahasia Anda pada Header permintaan. Jika kunci tidak ada atau tidak valid, server akan memutus koneksi dengan respon 401 Unauthorized.

X-API-KEY: [TOKEN_RAHASIA_ANDA]
Content-Type: application/json

Pelacakan Resi (B2B Endpoint)

Endpoint ini memberikan riwayat perjalanan paket yang telah disatukan (Unified Timeline). Seluruh status telah melalui proses standarisasi dan translasi otomatis oleh mesin eCargo, menghasilkan format yang siap saji untuk klien Anda.

GET https://api.auroragrup.com/indocargo/track.php

Query Parameters

tracking_id

Wajib

Nomor resi eCargo (Contoh: HK015952). Sistem akan otomatis melacak resi ekspedisi terkait.

Contoh Request (PHP cURL)

request_tracking.php

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.auroragrup.com/indocargo/track.php?tracking_id=HK015952",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-API-KEY: IC_AURORA_SECURE_2026", // Ganti dengan Token Asli Anda
        "Content-Type: application/json"
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Struktur Respon (Data Matang)

Struktur JSON di bawah ini adalah representasi dari penggabungan data Internal eCargo Hub, Otoritas Bea Cukai, dan Ekspedisi Last-Mile.

response_200_ok.json

{
  "status": "success",
  "tracking_id": "HK015952",
  "summary": {
    "shipper": "OKTAFIYANI",
    "consignee": "ANDI ARDIANTO",
    "expedition_id": "201408498368",
    "current_status": "EKSPEDISI: KELUAR DARI GUDANG TRANSIT",
    "last_updated": "2026-03-02 12:21:12"
  },
  "timeline": [
    {
      "date": "2026-03-02 12:21:12",
      "status": "EKSPEDISI: KELUAR DARI GUDANG TRANSIT",
      "location": "KOTA SALATIGA",
      "note": "【Kota Salatiga】Paket sedang diantar oleh kurir BIMA HAFIZH"
    },
    {
      "date": "2026-02-27 14:14:46",
      "status": "HANDOVER",
      "location": "ECARGO HUB",
      "note": ""
    },
    {
      "date": "2026-02-25 10:42:00",
      "status": "BEA CUKAI: TELAH DILUNASI",
      "location": "TPS SURABAYA / TANJUNG PERAK",
      "note": "Telah Dilunasi."
    },
    {
      "date": "2026-02-25 04:02:00",
      "status": "BEA CUKAI: PENERBITAN BILLING",
      "location": "TPS SURABAYA / TANJUNG PERAK",
      "note": "Penerbitan Billing."
    },
    {
      "date": "2026-02-23 09:00:00",
      "status": "PROSES CUSTOMS",
      "location": "ECARGO HUB",
      "note": ""
    }
  ]
}

Kode Status Error

API eCargo menggunakan kode status HTTP standar. Pesan error akan selalu dikembalikan dalam format JSON dengan key status: "error".

401

Unauthorized

Header X-API-KEY tidak disertakan atau token yang diberikan tidak memiliki izin akses.

404

Not Found

Nomor resi (tracking_id) tidak terdaftar di dalam ekosistem database eCargo.

500

Server Error

Terjadi anomali pada mesin integrasi. Hubungi tim teknis Aurora.