Historial
Endpoints del historial de clasificacion - consulte, filtre y recupere el detalle de sus clasificaciones pasadas.
Los endpoints de historial permiten consultar y filtrar todas sus clasificaciones pasadas. Cada clasificacion realizada a traves de la API se registra automaticamente y es accesible.
Listar el historial de clasificaciones
GET
/v1/classify/historyParametros de consulta
| Parametro | Tipo | Defecto | Descripcion |
|---|---|---|---|
page | number | 1 | Numero de pagina |
per_page | number | 20 | Resultados por pagina (max 50) |
from | string (ISO 8601) | - | Fecha de inicio (incluida) |
to | string (ISO 8601) | - | Fecha de fin (incluida) |
hs | string | - | Filtrar por codigo HS (se acepta prefijo, ej: 8518) |
status | string | - | Filtrar por estado: completed, failed |
source | string | - | Filtrar por fuente: api, web, batch |
all_keys | boolean | false | Incluir clasificaciones de todas las claves API de la organizacion |
Ejemplo de solicitud
curl "https://api.thetradehub.eu/v1/classify/history?page=1&per_page=10&status=completed&from=2026-02-01T00:00:00Z" \
-H "X-API-Key: th_live_su_clave_api"Respuesta
{
"items": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "completed",
"content": "Auriculares Bluetooth inalambricos",
"result": {
"classification": {
"rankings": [
{
"rank": 1,
"hs_code": "8518.30.00",
"description": "Auriculares y cascos",
"confidence": 0.94
}
]
}
},
"source": "api",
"api_key_name": "Production Key",
"created_at": "2026-02-24T10:30:00Z"
}
],
"total": 156,
"page": 1,
"per_page": 10,
"pages": 16
}Estructura de la respuesta paginada
| Campo | Tipo | Descripcion |
|---|---|---|
items | object[] | Lista de clasificaciones |
total | number | Numero total de resultados |
page | number | Pagina actual |
per_page | number | Resultados por pagina |
pages | number | Numero total de paginas |
Detalle de una clasificacion
GET
/v1/classify/history/{log_id}Parametros de ruta
| Parametro | Tipo | Descripcion |
|---|---|---|
log_id | string (UUID) | Identificador de la clasificacion |
Ejemplo de solicitud
curl https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "X-API-Key: th_live_su_clave_api"Respuesta
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "completed",
"content": "Auriculares Bluetooth inalambricos con cancelacion activa de ruido",
"image_urls": ["https://example.com/product/headphones.jpg"],
"locale": "es",
"result": {
"classification": {
"rankings": [
{
"rank": 1,
"hs_code": "8518.30.00",
"description": "Auriculares y cascos",
"confidence": 0.94,
"gri_justification": "RGI 1 - El producto esta expresamente cubierto por la posicion 8518...",
"validated": true
}
]
},
"text": "Basado en las decisiones IVO de la UE y la nomenclatura TARIC..."
},
"source": "api",
"api_key_name": "Production Key",
"session_id": "sess_abc123",
"created_at": "2026-02-24T10:30:00Z",
"updated_at": "2026-02-24T10:30:05Z"
}Filtros avanzados
Filtro por codigo HS
El parametro hs acepta un prefijo de codigo HS. Filtra las clasificaciones cuyo primer resultado comienza con ese prefijo:
# Todos los productos clasificados en el capitulo 85 (maquinas y aparatos electricos)
curl "https://api.thetradehub.eu/v1/classify/history?hs=85" \
-H "X-API-Key: th_live_su_clave_api"
# Partida especifica 8518 (microfonos, altavoces, auriculares)
curl "https://api.thetradehub.eu/v1/classify/history?hs=8518" \
-H "X-API-Key: th_live_su_clave_api"Filtro por periodo
Combine from y to para restringir el periodo. Las fechas deben estar en formato ISO 8601:
# Clasificaciones de febrero 2026
curl "https://api.thetradehub.eu/v1/classify/history?from=2026-02-01T00:00:00Z&to=2026-02-28T23:59:59Z" \
-H "X-API-Key: th_live_su_clave_api"Visibilidad multi-clave
Por defecto, solo se devuelven las clasificaciones realizadas con la clave API utilizada para la llamada. Active all_keys=true para ver las clasificaciones de todas las claves de su organizacion:
curl "https://api.thetradehub.eu/v1/classify/history?all_keys=true" \
-H "X-API-Key: th_live_su_clave_api"Last updated on