Para empezar
Autenticación
Autenticá tus requests con una API key de Clasificar.
API v1AnteriorHeader de autenticación
Enviá la credencial en x-api-key para cada request. Los ejemplos de esta documentación usan ese header.
HTTP
x-api-key: clk_tu_api_keyV1 también acepta Authorization: Bearer. Usá una sola forma por request; si enviás ambas, el header x-api-key tiene prioridad.
Seguridad de la integración
Guardá la key en una variable de entorno del servidor. Las requests de tu frontend deben pasar por tu servidor para que la credencial no quede expuesta al navegador.
- No publiques la key en URLs, logs ni repositorios.
- Usá una key identificable por integración para poder revocarla de forma independiente.
- Si una key se expone, reemplazala y revocá la anterior desde tu cuenta.
Errores de acceso
| HTTP | Qué revisar |
|---|---|
401 | La key puede faltar, ser inválida o estar revocada. |
403 | La opción o el módulo puede requerir un plan o contrato habilitado. |