Obtener Token

Para obtener un token, envía una solicitud POST al endpoint de token de la API con tus credenciales en el body:

• accessKey: clave pública (por ejemplo, sheriff_XXX).
• accessSecret: secreto asociado (por ejemplo, password).

Ejemplo con curl

curl -X POST "https://prod.api.thesheriff.cl/api/clients/v3/apiCredentials/getToken" \
  -H "Content-Type: application/json" \
  -d '{"accessKey":"sheriff_XXX","accessSecret":"password"}'

Respuesta de ejemplo

{
  "success": true,
  "data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123"
}

Nota:

• El campo data contiene el token de acceso (JWT) que autentica tus solicitudes a la API.
• El token es válido por 2 horas desde su emisión. Pasado ese plazo, debes solicitar uno nuevo.
• Mientras tengas un token válido, no necesitas pedir otro: reutilízalo para evitar solicitudes innecesarias.
• El token es el mismo para la API v2 y la API v3. Un token obtenido en /api/clients/v2/apiCredentials/getToken también autentica las llamadas a /api/clients/v3/*.

Errores

Como este endpoint no usa token, no responde los errores comunes de los demás endpoints. Sus errores son:

Código	Cuándo ocurre	Mensaje en error
400	Falta accessKey en el body.	El campo 'accessKey' es requerido.
400	Falta accessSecret en el body.	El campo 'accessSecret' es requerido.
400	accessKey no es texto.	El campo 'accessKey' debe ser texto.
400	accessSecret viene vacío.	El campo 'accessSecret' no puede estar vacío.
401	El accessSecret no corresponde al accessKey.	Error de Autenticación: Credenciales no válidas
401	La credencial está desactivada.	La credencial de API se encuentra desactivada
401	La credencial no tiene un secreto configurado.	La credencial no tiene accessSecret configurado
404	No existe una credencial con ese accessKey.	Credencial no encontrada
429	Hubo varios intentos fallidos seguidos con la misma credencial.	Credencial bloqueada temporalmente por múltiples intentos fallidos
429	Se superó el límite de solicitudes por IP.	Demasiadas solicitudes de tokens. Cachee el token y reutilícelo hasta su expiración (2 horas).
429	Se superó el límite de solicitudes por credencial.	Demasiadas solicitudes para esta credencial. El token es válido por 2 horas.
500	Ocurrió un error inesperado.	Ocurrió un error interno. Intenta nuevamente más tarde.

Ante un 400, corrige el campo que indica el mensaje. Si superaste un límite de solicitudes (429), espera los segundos que indica el header Retry-After antes de reintentar y reutiliza el token mientras siga vigente (ver Rate Limits).

{
  "success": false,
  "code": 401,
  "error": "Error de Autenticación: Credenciales no válidas"
}