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
/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"import httpx
client = httpx.Client(
base_url="https://api.thetradehub.eu",
headers={"X-API-Key": "th_live_votre_cle_api"},
)
response = client.get("/v1/classify/history", params={
"page": 1,
"per_page": 10,
"status": "completed",
"from": "2026-02-01",
})
data = response.json()
print(f"Total : {data['total']} classements")
for item in data["items"]:
print(f" {item['id']} - {item['hs_code_1']} ({item['confidence_1']}) - {item['created_at']}")const params = new URLSearchParams({
page: "1",
per_page: "10",
status: "completed",
from: "2026-02-01",
});
const response = await fetch(
`https://api.thetradehub.eu/v1/classify/history?${params}`,
{ headers: { "X-API-Key": "th_live_votre_cle_api" } }
);
const data = await response.json();
console.log(`Total : ${data.total} classements`);
for (const item of data.items) {
console.log(` ${item.id} - ${item.hs_code_1} (${item.confidence_1}) - ${item.created_at}`);
}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
/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"response = client.get("/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890")
log = response.json()
print(f"Produit : {log['input_content']}")
print(f"Code HS : {log['hs_code_1']}")
# Le résultat complet est dans full_result
rankings = log["full_result"]["classification"]["rankings"]
for r in rankings:
print(f" {r['hs_code']} - {r['confidence']} - {r['gri_justification'][:80]}")const response = await fetch(
"https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
{ headers: { "X-API-Key": "th_live_votre_cle_api" } }
);
const log = await response.json();
console.log(`Produit : ${log.input_content}`);
// Le résultat complet est dans full_result
const rankings = log.full_result.classification.rankings;
for (const r of rankings) {
console.log(` ${r.hs_code} - ${r.confidence} - ${r.gri_justification}`);
}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
/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"Dernière mise à jour