Stable Pro API · v1

401 · unauthorized

La clave de la API falta o no es válida

Cuándo ocurre

Falta la cabecera Authorization: Bearer, o la clave no se puede usar. La respuesta lleva WWW-Authenticate: Bearer.

Campos adicionales

reason: Por qué la clave no es válida: uno de los motivos de abajo.

Motivos

`reason`	Significado
`missing`	No hay ninguna clave en la cabecera `Authorization: Bearer`.
`malformed`	La clave no tiene la forma de una clave de Stable Pro (`sp_live_` o `sp_test_` seguido de 40 letras y dígitos).
`wrong_environment`	Una clave `sp_test_` en producción, o una clave `sp_live_` en staging.
`unknown`	No existe ninguna clave así.
`connection_revoked`	El titular de la cuadra ha revocado la conexión: todas sus claves han dejado de funcionar.
`revoked`	El titular de la cuadra ha revocado esta clave.
`expired`	La clave ha llegado a su fecha de caducidad.
`rotated`	Una clave nueva ha sustituido a esta, y han terminado los 7 días en que funcionaban las dos.

Qué hacer

Pide al titular de la cuadra una clave válida (Ajustes → Conexiones en Stable Pro).

La respuesta

{
  "type": "https://stable-pro.com/docs/api/problems/unauthorized",
  "title": "The API key is missing or not valid",
  "status": 401,
  "detail": "…"
}

En title la API escribe siempre el texto en inglés: «The API key is missing or not valid».

Decide según type, nunca según detail: consulta Errores.