Pakete werden mithilfe eines strikten Zustandsautomaten verfolgt (Etikett erstellt → abgeholt → unterwegs → zur Zustellung unterwegs → zugestellt). Lesezugriffe sind öffentlich; jeder Schreibzugriff erfordert den Header „X-API-Key: cargo-key-123“ – ein anderes Authentifizierungsverfahren als die sonst üblichen Bearer-Token.
Basis-URL: https://funapi.dev/api/cargo/v1 · 9 Endpunkte · OpenAPI-3.1-Spezifikation und Postman-Collection verfügbar. Neu hier? Lesen Sie die Einstiegsanleitung.
Wo ist mein Paket?
GET /cargo/v1/shipments — Sendungen auflisten, nach Status filtern · Antwortet mit 200 400 Link zu diesem EndpunktGET /cargo/v1/shipments/{id} — Eine Sendung verfolgen · Antwortet mit 200 404 Link zu diesem EndpunktGET /cargo/v1/shipments/{id}/events — Verlauf verfolgen · Antwortet mit 200 404 Link zu diesem EndpunktGET /cargo/v1/shipments/{id}/eta — Voraussichtliche Lieferzeit (deterministischer Modus geeignet) · Antwortet mit 200 404 Link zu diesem EndpunktGET /cargo/v1/rates — Versandkosten nach Gewicht · Antwortet mit 200 400 Link zu diesem EndpunktSchreibvorgänge, geschützt durch X-API-Schlüssel
POST /cargo/v1/shipments — Erstellen Sie ein Versandetikett (X-API-Schlüssel) · Antwortet mit 201 400 401 Link zu diesem EndpunktPOST /cargo/v1/shipments/{id}/advance — Den Zustandsautomaten um einen Schritt weiterbewegen (X-API-Schlüssel) · Antwortet mit 200 401 404 409 Link zu diesem EndpunktPOST /cargo/v1/shipments/{id}/attempt-delivery — Zustellungsversuch – kann fehlschlagen, 3 Versuche führen zur Rückgabe (X-API-Schlüssel) · Antwortet mit 200 401 404 409 Link zu diesem EndpunktPUT /cargo/v1/shipments/{id}/address — Paket umleiten (X-API-Schlüssel + If-Match) · Antwortet mit 200 400 401 404 409 412 Link zu diesem EndpunktDie Cargo Tracking API ist eine Sendungsstatusmaschine – erstellt, abgeholt, unterwegs, zugestellt –, in der unzulässige Übergänge abgelehnt statt akzeptiert werden. Sie ist außerdem die einzige API im Katalog, die Schreibvorgänge mit einem X-API-Key-Header anstelle eines Bearer-Tokens authentifiziert. Dadurch eignet sie sich besonders zum Testen von Clients, die mehrere Authentifizierungsschemata unterstützen müssen.
GET https://funapi.dev/api/cargo/v1/shipments — Sendungen auflisten, nach Status filtern. Kein Token, keine Anmeldung:
curl -i https://funapi.dev/api/cargo/v1/shipments
Antwort: 200 OK
{
"total": 3,
"data": [
{
"id": "TRK123456",
"recipient": "Wile E. Coyote",
"status": "in-transit",
"attempts": 0
},
{
"id": "TRK777777",
"recipient": "Joey Tribbiani",
"status": "delivered",
"attempts": 1
},
{
"id": "TRK000001",
"recipient": "H. Potter",
"status": "label-created",
"attempts": 0
}
]
}
Diesen Endpunkt öffnen und ausführen
Zuletzt aktualisiert