La API de Camtom sigue los principios REST y utiliza JSON como formato de intercambio. Todos los endpoints requieren autenticacion via API key en el header Authorization. La API está versiónada (actualmente v2) y mantiene compatibilidad hacia atrás dentro de la misma versión mayor. La URL base es https://api.camtom.com/v2.
Desde tu panel de Camtom, navega a Configuracion > API > Generar clave. Obtendras una API key de tipo sk_live_... para produccion y sk_test_... para el entorno sandbox. Guarda la clave en un lugar seguro — no podrás verla de nuevo. Si la pierdes, genera una nueva y revoca la anterior.
Nunca expongas tu API key en código del lado del cliente (frontend). Utiliza variables de entorno en tu servidor y rotala periodicamente. Las claves de prueba tienen acceso completo al sandbox pero no afectan datos de produccion.
Para clasificar un producto, envía un POST a /v2/classify con el campo description en el body. La respuesta incluirá un array de sugerencias ordenadas por confianza, cada una con la fracción, descripción TIGIE, tasa arancelaria, regulaciones no arancelarias y un score de confianza entre 0 y 1. Un score superior a 0.85 indica alta confianza.
La API usa códigos HTTP estándar: 200 para exito, 400 para errores de validación, 401 para autenticacion fallida, 429 para exceso de solicitudes y 500 para errores internos. El rate limit por defecto es de 100 solicitudes por minuto. Si necesitas mayor capacidad, contacta a tu ejecutivo de cuenta para un plan personalizado.
Para operaciones que toman más tiempo, como la extracción de documentos complejos, puedes registrar un webhook URL. Camtom enviara un POST a tu endpoint cuando el procesamiento termine, incluyendo los resultados completos. Esto permite una integración no bloqueante ideal para flujos de trabajo de alto volumen.
Si prefieres no trabajar directamente con la API REST, ofrecemos SDKs oficiales para Node.js, Python y Go. Los SDKs manejan autenticacion, reintentos y páginacion automáticamente.
Equipo Camtom
Equipo Editorial
Mas de 100 agencias ya usan Camtom para optimizar sus procesos.