Cuando algo falla, la API responde con un código HTTP y un cuerpo JSON con el motivo. Estos son los códigos que puedes encontrar:
| HTTP | Código | Qué significa |
|---|---|---|
| 400 | json_invalido | El cuerpo no es JSON válido. |
| 401 | no_autorizado | Falta la llave o no es válida. |
| 403 | sin_permiso | La llave no tiene el permiso que pide ese endpoint. |
| 403 | ip_no_permitida | La llave solo funciona desde ciertas IPs. |
| 403 | llave_expirada | La llave venció: genera otra o pide que la rotes. |
| 404 | no_encontrado | La ruta o el recurso no existe. |
| 422 | campo_desconocido / valor_invalido / operador_invalido | Un dato enviado no es válido (el mensaje dice cuál y qué valores acepta). |
| 429 | limite_excedido | Superaste el límite por minuto. |
| 503 | api_deshabilitada | Esa API está apagada en Configuración › APIs y Webhooks. |