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.euVersionierung
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 ermöglicht die Verarbeitung komplexer Klassifizierungen, ohne Ihre Anwendung zu blockieren. Die durchschnittliche Verarbeitungszeit beträgt 3 bis 8 Sekunden.
Hauptendpunkte
Zolltarifliche Einreihung (ClassifyAI)
| 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 |
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
- Klassifizierung – Klassifizieren Sie Ihr erstes Produkt
- 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