eCargo Intelligence API

Selamat datang di gerbang **eCargo Hybrid Tracker Engine**. Endpoint terpadu ini dirancang berskala korporat untuk menyatukan lini pelacakan empat alam (*Unified Logs*) yaitu data Transaksi Inti, Manifes Bea Cukai, Dua Alam Gudang Internasional, serta pergerakan last-mile Ekspedisi Domestik secara instan.

Otentikasi Gerbang

Seluruh transmisi data Open API eCargo dilindungi enkripsi HTTPS dan verifikasi token. Pasang kredensial otorisasi Anda pada bagian **Header** permintaan. Server akan memblokir koneksi secara sepihak dan melempar respon 401 Unauthorized apabila token terdeteksi cacat atau tidak dikirim.

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

Unified Tracking Engine (Multi-Tenant Aggregator)

Endpoint ini memindai data secara kaskade dengan perlindungan *Firewall Anti-Recycle Resi*. Jika nomor resi masa lalu terdeteksi digunakan kembali di gudang sortir, sistem secara otomatis menghanguskan histori lama agar rekam pelacakan konsumen tidak tumpang tindih.

GET https://api.auroragrup.com/api/lacak-publik.php

Pilihan Parameter Masukan (Query Parameters)

Parameter	Sifat	Deskripsi Taktis
ref	Kondisional	Token resi terenkripsi aman (Masked String via AuroraVault). Sangat direkomendasikan untuk URL tracking publik konsumen.
kode	Kondisional	Nomor resi plain-text asli / No. AWB legasi standar B2B (Contoh: `HK022462`). Bisa dilempar via request parameter.

Contoh Integrasi Permintaan (PHP cURL)

lacak_fleet_engine.php

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.auroragrup.com/api/lacak-publik.php?kode=HK022462",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-API-KEY: IC_AURORA_SECURE_2026", // Suntikkan token B2B resmi Anda
        "Content-Type: application/json"
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Struktur Payload Keluaran (Data Matang Terpadu)

Setiap array didalam tracking_history diproduksi secara kronologis terbalik berkat asimilasi sensor *Sultan Hybrid Injector*.

unified_response_200.json

{
  "status": "success",
  "masked_id": "U0doc3VYVmxYM05sYTNOMU=",
  "header": {
    "id": "HK022462",
    "info": "HONGKONG ➔ SEMARANG"
  },
  "data": {
    "tracking_number": "HK022462",
    "resi_jnt": "201408498368",
    "tracking_history": [
      {
        "timestamp": "2026-05-21 07:12:00",
        "status": "Keluar Gudang",
        "remarks": "【Semarang Transit Hub】Paket dalam pengantaran kurir last-mile",
        "location": "Semarang, Indonesia",
        "source": "jnt_public"
      },
      {
        "timestamp": "2026-05-20 15:01:00",
        "status": "Unloading",
        "remarks": "Paket tiba di gudang pusat sortir",
        "location": "Hongkong",
        "source": "gudang_internal"
      },
      {
        "timestamp": "2026-05-20 13:30:00",
        "status": "Telah Dipickup",
        "remarks": "Barang masuk ke Kontainer: SEGU5539226",
        "location": "SURABAYA",
        "source": "gudang_internal"
      },
      {
        "timestamp": "2026-05-18 10:42:00",
        "status": "Bea Cukai: Telah Dilunasi",
        "remarks": "Dokumen Clearance Selesai Terbit SPPB",
        "location": "Surabaya, Indonesia",
        "source": "customs_fixed"
      }
    ]
  }
}

Matriks Kode Informasi Sumber (`source`)

Guna memudahkan pemetaan visual tracking di sisi aplikasi internal klien Anda, gunakan rujukan parameter source berikut sebagai penanda asal log data:

String Source	Asal Radar Transmisi
order / shipment	Database core transaksi internal pangkalan utama eCargo.
gudang_internal	Aktivitas penanganan fisik di dua alam manifes gudang (Kiriman / Titipan Mandiri).
customs_fixed	Injeksi data manifes clearance Bea Cukai regional pelabuhan tujuan.
jnt / jnt_public	Ghost Protocol Integrator, jembatan data langsung dari pelacakan ekspedisi publik.

Kode Status Penolakan Error

Sistem merespon dengan standarisasi kode HTTP error. Setiap kegagalan pemrosesan data dibungkus menggunakan enkapsulasi JSON seragam ber-key status: "error".

401

Unauthorized

Header X-API-KEY tidak valid, kedaluwarsa, atau tidak dikirim ke gerbang pertahanan.

404

Not Found

Nomor resi/AWB kosong atau tidak ditemukan jejak kehidupannya di seluruh kluster pangkalan eCargo.

500

Server Error

Terjadi gangguan transmisi jembatan data integrasi. Tim operasional Aurora segera bertindak.