Introduccion
Presentacion de la API The Trade Hub - clasificacion aduanera automatizada y control de exportacion de bienes de doble uso.
La API The Trade Hub permite integrar la clasificacion aduanera automatizada y el control de exportacion de bienes de doble uso directamente en sus sistemas.
URL base
Todas las solicitudes se envian a:
https://api.thetradehub.euVersionado
La API se versiona a traves de la ruta URL. La version actual es v1:
https://api.thetradehub.eu/v1/...Los cambios incompatibles daran lugar a una nueva version mayor. La adicion de campos nuevos en las respuestas se considera retrocompatible.
Formato de datos
- Todas las solicitudes y respuestas utilizan el formato JSON.
- El encabezado
Content-Type: application/jsondebe incluirse en todas las solicitudes con cuerpo. - Las fechas siguen el formato ISO 8601 (
2026-02-24T10:30:00Z). - Los identificadores son UUID v4.
Patron asincrono (jobs)
Las operaciones de clasificacion utilizan un patron asincrono basado en jobs:
- Crear un job - Envie una solicitud
POSTpara iniciar el procesamiento. Recibira inmediatamente un identificador de job. - Consultar el estado - Realice solicitudes
GETcon el identificador para seguir el progreso. - Obtener resultados - Cuando el estado cambia a
completed, la respuesta contiene los resultados completos.
POST /v1/classify/jobs → { "id": "...", "status": "pending" }
GET /v1/classify/jobs/{id} → { "id": "...", "status": "completed", "result": { ... } }Este patron permite procesar clasificaciones complejas sin bloquear su aplicacion. El tiempo medio de procesamiento es de 3 a 8 segundos.
Endpoints principales
Clasificacion aduanera (ClassifyAI)
| Endpoint | Metodo | Descripcion |
|---|---|---|
/v1/classify/jobs | POST | Crear un job de clasificacion |
/v1/classify/jobs/{id} | GET | Obtener el estado y los resultados de un job |
/v1/classify/batch | POST | Clasificacion por lotes (hasta 1 000 productos) |
/v1/classify/batch/{id} | GET | Estado de un lote de clasificacion |
/v1/classify/history | GET | Historial de clasificaciones |
/v1/classify/history/{id} | GET | Detalle de una clasificacion |
Export Control
| Endpoint | Metodo | Descripcion |
|---|---|---|
/v1/export-control/chat | POST | Clasificacion SSE streaming de bienes de doble uso |
/v1/export-control/jobs | POST | Job asincrono de clasificacion export control |
/v1/export-control/jobs/{id} | GET | Estado de un job export control |
/v1/export-control/sessions | GET | Listar sesiones de clasificacion |
/v1/export-control/sessions/{id} | GET | Detalle de una sesion |
/v1/export-control/quota | GET | Verificar cuota restante |
Proximos pasos
- Autenticacion - Configure su clave API
- Clasificacion - Clasifique su primer producto
- Clasificacion por lotes - Procese varios productos a la vez
- Export Control - Clasifique bienes de doble uso
- Limitacion de velocidad - Comprenda los limites
- Gestion de errores - Comprenda los codigos de error
Última actualización