Schnellstart
Klassifizieren Sie Ihr erstes Produkt in 5 Minuten mit der The Trade Hub API.
Diese Anleitung führt Sie von der Kontoerstellung bis zur ersten Zolltariflichen Einreihung über die API. In 5 Minuten sind Sie startklar.
Voraussetzungen
- Ein moderner Webbrowser
- Ein Werkzeug für HTTP-Anfragen (
curl, Postman oder Ihre bevorzugte Programmiersprache)
Konto und Organisation erstellen
Gehen Sie zu The Trade Hub und erstellen Sie Ihr Konto. Sie können sich mit Ihrer E-Mail-Adresse oder über Google/Microsoft anmelden.
Nach dem Login erstellen Sie eine Organisation. Die Organisation ist die Einheit, die Ihre API-Schlüssel, Nutzung und Mitglieder gruppiert.
- Klicken Sie im Dashboard auf „Organisation erstellen“
- Geben Sie Ihren Firmennamen ein
- Wählen Sie einen eindeutigen Slug (z. B.
my-company)
API-Schlüssel generieren
Wechseln Sie in Ihrer Organisation zur Entwickler-Seite:
- Gehen Sie zu Organisation > Entwickler
- Klicken Sie auf „API-Schlüssel erstellen“
- Vergeben Sie einen aussagekräftigen Namen für Ihren Schlüssel (z. B.
dev-local,production) - Wählen Sie die benötigten Berechtigungen aus (
classifyfür Klassifizierung,export_controlfür Exportkontrolle) - Kopieren Sie den angezeigten Schlüssel – er wird nicht erneut sichtbar sein
Schlüsselformat:
th_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxErste Klassifizierung
Erstellen Sie mit Ihrem API-Schlüssel einen Klassifizierungsauftrag:
curl -X POST https://api.thetradehub.eu/v1/classify/jobs \
-H "X-API-Key: th_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"content": "USB-C to Lightning cable for iPhone, 1m length, white color"
}'Die Anfrage ist asynchron. Sie erhalten sofort eine Auftrags-ID:
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "pending",
"created_at": "2026-02-25T10:30:00Z",
"updated_at": "2026-02-25T10:30:00Z"
}Ergebnisse abrufen
Fragen Sie den Status des Auftrags ab, bis die Ergebnisse vorliegen:
curl https://api.thetradehub.eu/v1/classify/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "X-API-Key: th_live_your_api_key"Nach Abschluss der Verarbeitung (3 bis 8 Sekunden) erhalten Sie das vollständige Ergebnis:
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "completed",
"result": {
"classification": {
"rankings": [
{
"rank": 1,
"hs_code": "8544.42.90",
"description": "Elektrische Kabel für Spannung <= 1000V, mit Steckverbindern",
"confidence": 0.94,
"gri_justification": "GIR 1 - Position 8544 umfasst elektrische Kabel...",
"validated": true
}
]
},
"text": "Basierend auf EU verbindlichen Zolltarifauskünften und TARIC-Nomenklatur...",
"session_id": "sess_abc123"
},
"created_at": "2026-02-25T10:30:00Z",
"updated_at": "2026-02-25T10:30:05Z"
}Wichtige Antwortfelder:
| Feld | Beschreibung |
|---|---|
rankings[].hs_code | Harmonisiertes System (HS) Code (6, 8 oder 10 Stellen) |
rankings[].confidence | Vertrauenswert (0 bis 1) |
rankings[].gri_justification | Begründung basierend auf den Allgemeinen Auslegungsregeln (GIR) |
rankings[].validated | true, wenn der Code in der TARIC-Nomenklatur verifiziert wurde |
Nächste Schritte
- Siehe die Classification API Referenz für vollständige Parameter- und Antwortdetails
- Erkunden Sie die Batch-Klassifizierung zur Verarbeitung mehrerer Produkte
- Entdecken Sie Integrationsmuster für Best Practices im Produktiveinsatz
- Durchsuchen Sie die Referenzen für Zollreferenzdaten
Last updated on