Einführung
Überblick über die The Trade Hub API – automatisierte zolltarifliche Einreihung und Exportkontrolle für Dual-Use-Güter.
Die The Trade Hub API ermöglicht Ihnen die Integration automatisierter zolltariflicher Einreihung und Exportkontrolle für Dual-Use-Güter direkt in Ihre Systeme.
Basis-URL
Alle Anfragen werden gesendet an:
https://api.thetradehub.euÖffentlichen OpenAPI-Vertrag herunterladen
Versionierung
Die API wird über den URL-Pfad versioniert. Die aktuelle Version ist v1:
https://api.thetradehub.eu/v1/...Breaking Changes führen zu einer neuen Hauptversion. Das Hinzufügen neuer Felder zu Antworten gilt als abwärtskompatibel.
Datenformat
- Alle Anfragen und Antworten verwenden das JSON-Format.
- Der Header
Content-Type: application/jsonmuss bei allen Anfragen mit Body enthalten sein. - Datumsangaben folgen dem ISO 8601-Format (
2026-02-24T10:30:00Z). - Identifikatoren sind UUID v4.
Asynchrones Muster (Jobs)
Klassifizierungsoperationen verwenden ein asynchrones jobbasiertes Muster:
- Job erstellen – Senden Sie eine
POST-Anfrage, um die Verarbeitung zu starten. Sie erhalten sofort eine Job-ID. - Status abfragen – Machen Sie
GET-Anfragen mit der ID, um den Fortschritt zu verfolgen. - Ergebnisse abrufen – Wenn der Status auf
completedwechselt, enthält die Antwort die vollständigen Ergebnisse.
POST /v1/classify/jobs → { "id": "...", "status": "pending" }
GET /v1/classify/jobs/{id} → { "id": "...", "status": "completed", "result": { ... } }Dieses Muster verarbeitet komplexe Einreihungen, ohne Ihre Anwendung zu blockieren. Verwenden Sie 12 Minuten für operational und 18 Minuten für legal_deep.
Hauptendpunkte
Zolltarifliche Einreihung für EU und China
| Endpunkt | Methode | Beschreibung |
|---|---|---|
/v1/classify/jobs | POST | Erstellen eines Klassifizierungsjobs |
/v1/classify/jobs/{id} | GET | Jobstatus und Ergebnisse abrufen |
/v1/classify/batch | POST | Stapelklassifizierung (bis zu 1.000 Artikel) |
/v1/classify/batch/{id} | GET | Status der Stapelklassifizierung |
/v1/classify/history | GET | Klassifizierungshistorie |
/v1/classify/history/{id} | GET | Details einer einzelnen Klassifizierung |
/v1/classify-china/jobs | POST | China-Job für GACC10/CIQ13 erstellen |
/v1/classify-china/jobs/{id} | GET | China-Jobstatus und Ergebnis abrufen |
/v1/classify-china/batch | POST | China-Batch erstellen |
/v1/classify-china/batch/{id} | GET | China-Batchstatus und Ergebnisse abrufen |
Exportkontrolle
| Endpunkt | Methode | Beschreibung |
|---|---|---|
/v1/export-control/chat | POST | SSE-Streaming-Klassifizierung für Dual-Use-Güter |
/v1/export-control/jobs | POST | Asynchroner Exportkontroll-Klassifizierungsjob |
/v1/export-control/jobs/{id} | GET | Status des Exportkontroll-Jobs |
/v1/export-control/sessions | GET | Liste der Klassifizierungssitzungen |
/v1/export-control/sessions/{id} | GET | Sitzungsdetails |
/v1/export-control/quota | GET | Verbleibendes Kontingent prüfen |
Nächste Schritte
- Authentifizierung – Richten Sie Ihren API-Schlüssel ein
- EU- und China-Einreihung - Verbinden und erstes Ergebnis abrufen
- Stapelklassifizierung – Verarbeiten Sie mehrere Produkte gleichzeitig
- Exportkontrolle – Klassifizieren Sie Dual-Use-Güter
- Rate Limiting – Verstehen Sie die Ratenbegrenzungen
- Fehlerbehandlung – Verstehen Sie Fehlercodes
Last updated on