Autenticación

Usar una API key#

En cada request autenticado enviá tu API key mediante el header:

x-api-key: <TU_API_KEY>

curl 'https://api.clasific.ar/v2/vehicles/ZZ000ZZ' \
  -H 'x-api-key: <TU_API_KEY>'

Las API keys deben utilizarse desde tu servidor. No las expongas en aplicaciones frontend, repositorios públicos ni código distribuido al cliente.

Ambientes#

El entorno Sandbox utiliza datos de prueba y tiene consumo separado de Producción. Usá la misma estructura de endpoints en ambos ambientes:

https://api.clasific.ar/v2/...
https://sandbox.clasific.ar/v2/...

Cuenta y límites#

Todas las API keys de una misma cuenta comparten, dentro de cada ambiente:

• El plan contratado.
• Los cupos de consultas.
• Los límites de requests por minuto.
• Las operaciones creadas.

Podés rotar o crear nuevas API keys sin reiniciar el consumo de tu cuenta.

Errores de autenticación#

Una API key ausente o inválida devuelve HTTP 401 Unauthorized. Una key revocada deja de poder utilizarse inmediatamente.

{
  "error": {
    "code": "invalid_api_key",
    "message": "An active x-api-key is required.",
    "requestId": "req_example",
    "retryable": false
  }
}

Revisá que estés enviando una API key activa y que el header esté escrito como x-api-key.