API-Entwicklungsdokument zur Abfrage des Sendungsstatus

Paketreise

Die API bestimmt anhand der Bestellnummer automatisch, in welcher Phase sich das Paket befindet, und gibt den aktuellen Status, den vollständigen Zeitplan und (sofern es beim taiwanesischen Zoll angekommen ist) den fünfstufigen GC329-Zollabfertigungsfortschritt zurück.

Base URL

Authentifizierungsheader (wählen Sie einen aus)

Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx
// 或
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Bitte rufen Sie es serverseitig auf und geben Sie den Schlüssel nicht in Front-End-JavaScript ein. Das Ratenlimit wird in Schlüsseleinheiten angegeben und der Antwortheader X-RateLimit-Remaining meldet das verbleibende Limit. Wenn das Limit überschritten wird, wird HTTP 429 zurückgegeben.

GETPOST /api/v1/shipment/track

Überprüfen Sie den Sendungsstatus eines einzelnen Pakets anhand der Sendungsverfolgungsnummer. Sowohl GET (Abfragezeichenfolge) als auch POST (JSON/Formular) sind akzeptabel.

Parameter anfordern

Anforderungsbeispiel (GET)

curl "https://0523.tw/api/v1/shipment/track?tracking_number=SF1234567890123" \
  -H "Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

Antwort 200 (Beispiel bereits im Lager/im Transport)

{
  "success": true,
  "cached": false,
  "tracking_number": "SF1234567890123",
  "data": {
    "tracking_number": "SF1234567890123",
    "customer_order_no": "LK260601001",
    "carrier_tracking_no": "SF1234567890123",
    "logistics": "順豐速運",
    "status_code": 2,
    "status": "已入倉",
    "description": "包裹已進入深圳集運倉,等待集運打包",
    "is_delivered": false,
    "is_final": false,
    "last_event_time": "2026-06-01 12:30:00",
    "updated_at": "2026-06-01 12:31:05",
    "timeline": [
      { "name": "已攬收", "completed": true,  "time": "2026-05-30 09:00:00" },
      { "name": "已入倉 (深圳集運倉)", "completed": true,  "time": "2026-06-01 12:30:00" },
      { "name": "集運打包/台灣運送", "completed": false, "time": null },
      { "name": "已簽收", "completed": false, "time": null }
    ],
    "customs_stages": null,
    "events": null
  }
}

Antwort 404 (keine Bestellnummer gefunden)

{
  "success": false,
  "error": "not_found",
  "message": "查無此單號。請確認單號正確,或包裹尚未進入集運系統。",
  "tracking_number": "SF1234567890123"
}

Hauptphase der Konsolidierung (Zeitleiste)

Zollabfertigungsstufen (customs_stages,GC329)

Nachdem das Paket beim taiwanesischen Zoll angekommen ist, zeigt customs_stages den fünfstufigen Fortschritt und den Gesamtprozentsatz an:

{
  "hbl": "691MK539819",
  "trans_type_name": "海運",
  "current_stage_name": "海關放行",
  "progress_percent": 80,
  "is_completed": false,
  "stages": [
    { "code": "XX", "name": "船(機)抵達",   "done": true },
    { "code": "E1", "name": "連線收單建檔", "done": true },
    { "code": "D1", "name": "計稅",        "done": true },
    { "code": "RL", "name": "海關放行",     "done": true },
    { "code": "OW", "name": "出倉",        "done": false }
  ],
  "source": "關港貿單一窗口 GC329"
}

• Abfragehäufigkeit : Es wird empfohlen, alle 15-30 Minuten die gleiche Bestellnummer zu überprüfen; Das Ergebnis wird 5 Minuten lang auf diesem Server zwischengespeichert (cached: true bedeutet Treffer).
• stoppt die Abfrage. : Stoppt die Abfrage, wenn is_final = true (signiert/zurückgegeben/abgebrochen) ist.
• -Statustreiber : Anzeige mit status-Zeichenfolge. Verwenden Sie is_delivered / is_final, um den Prozess zu beurteilen und harte Codierung zu vermeiden status_code (verschiedene Quellcodedefinitionen sind unterschiedlich).
• Keine Bestellnummer :404 Bedeutet höchstwahrscheinlich, dass das Paket noch nicht in das Konsolidierungssystem gelangt ist (der Kunde hat gerade eine Bestellung aufgegeben, diese aber nicht gesendet), und Sie können es später noch einmal versuchen.

technische Unterstützung: howyunqisoftware@gmail.com

API-Version: v1 (stabil).

Änderungshistorie: 01.06.2026 – API v1 zur Abfrage des Sendungsstatus ist online.