Introduction
Présentation de l'API The Trade Hub - classement douanier UE et Chine et contrôle des exportations de biens à double usage.
L'API The Trade Hub permet d'intégrer le classement douanier UE et Chine et le contrôle des exportations de biens à double usage directement dans vos systèmes.
URL de base
Toutes les requêtes sont envoyées vers :
https://api.thetradehub.euTélécharger le contrat OpenAPI public
Versionnement
L'API est versionnée via le chemin d'URL. La version actuelle est v1 :
https://api.thetradehub.eu/v1/...Les changements rétro-incompatibles entraîneront une nouvelle version majeure. Les ajouts de champs dans les réponses sont considérés comme rétro-compatibles.
Format des données
- Toutes les requêtes et réponses utilisent le format JSON.
- L'en-tête
Content-Type: application/jsondoit être inclus dans toutes les requêtes avec un corps. - Les dates sont au format ISO 8601 (
2026-02-24T10:30:00Z). - Les identifiants sont des UUID v4.
Traitement asynchrone
Les opérations de classement utilisent des tâches asynchrones, appelées jobs dans le contrat :
- Créer une tâche - Envoyez une requête
POSTpour démarrer le traitement. Vous recevez immédiatement son identifiant. - Interroger le statut - Effectuez des requêtes
GETavec l'identifiant pour suivre l'avancement. - Récupérer les résultats - Lorsque le statut passe à
completed, la réponse contient les résultats complets.
POST /v1/classify/jobs → { "id": "...", "status": "pending" }
GET /v1/classify/jobs/{id} → { "id": "...", "status": "completed", "result": { ... } }Ce fonctionnement permet de traiter des classements complexes sans bloquer votre application. Prévoyez un délai client de 12 minutes en mode operational et de 18 minutes en mode legal_deep.
Endpoints principaux
Classement douanier UE et Chine
| Endpoint | Méthode | Description |
|---|---|---|
/v1/classify/chat | POST | Classement en flux SSE en temps réel |
/v1/classify/jobs | POST | Créer une tâche de classement asynchrone |
/v1/classify/jobs/{id} | GET | Obtenir le statut et les résultats d'une tâche |
/v1/classify/batch | POST | Classement par lot (jusqu'à 1 000 produits) |
/v1/classify/batch/{id} | GET | Statut d'un lot de classement |
/v1/classify/history | GET | Historique des classements |
/v1/classify/history/{id} | GET | Détail d'un classement |
/v1/classify/history/export | GET | Export CSV des classements |
/v1/classify-china/jobs | POST | Créer un job de classement Chine GACC10/CIQ13 |
/v1/classify-china/jobs/{id} | GET | Obtenir le statut et le résultat Chine |
/v1/classify-china/batch | POST | Créer un lot de classements Chine |
/v1/classify-china/batch/{id} | GET | Obtenir le statut et les résultats du lot Chine |
Contrôle des exportations
| Endpoint | Méthode | Description |
|---|---|---|
/v1/export-control/chat | POST | Classement SSE streaming des biens double usage |
/v1/export-control/jobs | POST | Job asynchrone de classement export control |
/v1/export-control/jobs/{id} | GET | Statut d'un job export control |
/v1/export-control/sessions | GET | Lister les sessions de classement |
/v1/export-control/sessions/{id} | GET | Détail d'une session |
/v1/export-control/quota | GET | Vérifier le quota restant |
Prochaines étapes
- Authentification - Configurez votre clé API
- Classement UE et Chine - Connectez-vous et récupérez votre premier résultat
- Classement par lot - Traitez plusieurs produits à la fois
- Export Control - Classez les biens double usage
- Limitation de débit - Comprenez les limites
- Gestion des erreurs - Comprenez les codes d'erreur
Last updated on