Introduction
Présentation de l'API The Trade Hub - classement douanier automatisée et contrôle export des biens double usage.
L'API The Trade Hub permet d'intégrer le classement douanier automatisée et le contrôle export des biens double usage directement dans vos systèmes.
URL de base
Toutes les requêtes sont envoyées vers :
https://api.thetradehub.euVersionnement
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.
Pattern asynchrone (jobs)
Les opérations de classement utilisent un pattern asynchrone basé sur des jobs :
- Créer un job - Envoyez une requête
POSTpour démarrer le traitement. Vous recevez immédiatement un identifiant de job. - 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 pattern permet de traiter des classements complexes sans bloquer votre application. La durée moyenne de traitement est de 3 à 8 secondes.
Endpoints principaux
Classement douanier (ClassifyAI)
| Endpoint | Méthode | Description |
|---|---|---|
/v1/classify/chat | POST | Classement SSE streaming (temps reel) |
/v1/classify/jobs | POST | Créer un job de classement asynchrone |
/v1/classify/jobs/{id} | GET | Obtenir le statut et les résultats d'un job |
/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 |
Export Control
| 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 - Classez votre premier produit
- 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
Dernière mise à jour