Saltar al contenido
Docs

Respuestas de error

401

Sin autenticar

La API devuelve "title": "UNAUTHORIZED"

Un error en la petición. Hay algo que cambiar antes de volver a mandarla.

No sabemos quién eres. La cabecera x-api-key falta, o el valor que lleva no corresponde a una credencial válida y vigente.

Las cuatro causas, en orden de frecuencia

  1. Falta la cabecera. Se escribe x-api-key, no Authorization ni X-Api-Key con otro formato.
  2. Es la llave del otro ambiente. Una credencial de pruebas no sirve en producción, ni al revés. Es la causa número uno cuando algo funcionaba y de pronto deja de hacerlo.
  3. Expiró. Las llaves viven 365 días.
  4. Se revocó. Si alguien de tu equipo ejecutó POST /v1/partner/api-keys/rotate, la llave anterior dejó de servir en el acto.

Cómo comprobarlo

Terminal window
curl -i https://api.slan.mx/v1/partner/ping -H "x-api-key: slan_..."

Es la llamada más barata de la API y no toca ningún dato. Si responde 200, la credencial está bien y el problema está en otro sitio.

Reintentar

No sirve de nada hasta que cambies la credencial. Lee Credenciales para rotarla o pedir una nueva.

Códigos que aparecen con este estado

Programa contra el campo code, nunca contra detail: la redacción puede cambiar, el código no.

codeQué significa
UNAUTHORIZEDFalta la cabecera x-api-key, o la llave no existe, expiró o fue revocada

Llegaste aquí desde el campo type de una respuesta de error. La guíaErrores explica el formato completo y qué hacer con cada campo.