Historique
Endpoints d'historique de classement - consultez, filtrez et exportez vos classements passes.
Les endpoints d'historique permettent de consulter et filtrer l'ensemble de vos classements. Chaque classement effectue via l'API est automatiquement enregistre et accessible.
Lister l'historique
GET
/v1/classify/historyParamètres de requete
| Paramètre | Type | Defaut | Description |
|---|---|---|---|
page | number | 1 | Numero de page |
per_page | number | 20 | Nombre de résultats par page (max 50) |
from | string (date ISO 8601) | 30 jours | Date de debut (incluse) |
to | string (date ISO 8601) | aujourd'hui | Date de fin (incluse) |
hs | string | - | Filtrer par code HS (prefixe accepte, ex: 8518) |
status | string | - | Filtrer par statut : completed, failed |
source | string | - | Filtrer par source : api, web, job |
all_keys | boolean | false | Inclure les classements de toutes les clés API de l'organisation |
Exemple de requete
curl "https://api.thetradehub.eu/v1/classify/history?page=1&per_page=10&status=completed&from=2026-02-01" \
-H "X-API-Key: th_live_votre_cle_api"Réponse
{
"items": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"organization_id": "org-uuid",
"api_key_id": "key-uuid",
"job_id": "job-uuid",
"session_id": "sess_abc123",
"input_summary": "Casque audio Bluetooth sans fil",
"has_images": false,
"locale": "fr",
"hs_code_1": "8518.30.00",
"hs_description_1": "Ecouteurs et casques",
"confidence_1": 0.94,
"hs_code_2": "8517.62.00",
"hs_code_3": null,
"consolidation_confidence": 91,
"source": "api",
"classification_type": "sh",
"status": "completed",
"error_message": null,
"created_at": "2026-02-24T10:30:00Z",
"key_name": "Production Key",
"key_prefix": "th_live_a1b2"
}
],
"total": 156,
"page": 1,
"per_page": 10
}Structure de la réponse paginee
| Champ | Type | Description |
|---|---|---|
items | object[] | Liste des classements |
total | number | Nombre total de résultats |
page | number | Page courante |
per_page | number | Nombre de résultats par page |
Champs de chaque element
| Champ | Type | Description |
|---|---|---|
id | string (UUID) | Identifiant unique du classement |
input_summary | string | Resume du produit classe (200 caracteres max) |
has_images | boolean | true si des images ont ete fournies |
hs_code_1 | string | Code HS du premier résultat |
hs_description_1 | string | Description du premier résultat |
confidence_1 | number | Score de confiance du premier résultat |
hs_code_2 | string | Code HS du deuxieme résultat |
hs_code_3 | string | Code HS du troisieme résultat |
consolidation_confidence | number | Score de confiance global (0-100) |
source | string | Source : api, web ou job |
classification_type | string | sh (classement douanier) ou export_control |
status | string | completed ou failed |
error_message | string | Message d'erreur si status = failed |
created_at | string | Date de creation (ISO 8601) |
key_name | string | Nom de la clé API utilisee |
key_prefix | string | Prefixe de la clé API (th_live_xxxx) |
Detail d'un classement
GET
/v1/classify/history/{log_id}Le detail retourne tous les champs de la liste, plus le résultat complet du classement (full_result) et le contenu d'entree integral (input_content).
Paramètres de chemin
| Paramètre | Type | Description |
|---|---|---|
log_id | string (UUID) | Identifiant du classement |
Exemple de requete
curl https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "X-API-Key: th_live_votre_cle_api"Champs supplementaires (detail uniquement)
| Champ | Type | Description |
|---|---|---|
input_content | string | Texte d'entree complet |
full_result | object | Résultat complet du classement (structure identique au champ result de /v1/classify/jobs/{id}) |
Exporter en CSV
GET
/v1/classify/history/exportRetourne un fichier CSV avec tous les classements correspondant aux filtres. Memes paramètres que l'endpoint de liste (sauf pagination).
curl "https://api.thetradehub.eu/v1/classify/history/export?from=2026-01-01&to=2026-03-11" \
-H "X-API-Key: th_live_votre_cle_api" \
-o classements.csvFiltres avances
Filtrage par code HS
Le parametre hs accepte un prefixe de code HS :
# Tous les produits classes au chapitre 85
curl "https://api.thetradehub.eu/v1/classify/history?hs=85" \
-H "X-API-Key: th_live_votre_cle_api"
# Position specifique 8518 (microphones, haut-parleurs, casques)
curl "https://api.thetradehub.eu/v1/classify/history?hs=8518" \
-H "X-API-Key: th_live_votre_cle_api"Visibilite multi-clés
Par defaut, seuls les classements effectues avec la clé API utilisee pour l'appel sont retournes. Activez all_keys=true pour voir les classements de toutes les clés de votre organisation :
curl "https://api.thetradehub.eu/v1/classify/history?all_keys=true" \
-H "X-API-Key: th_live_votre_cle_api"Last updated on