Desarrolladores

Errores

Forma de las respuestas de error de la API de Blogenia, códigos HTTP y códigos de error propios.

Los errores usan el código HTTP correspondiente y un cuerpo JSON con la misma forma.

Campos

Campo	Tipo	Descripción
`statusCode`	number	Código HTTP.
`error`	string	Nombre estándar del código HTTP.
`message`	string \| string[]	Explicación en español. En errores de validación puede ser una lista de textos.
`requestId`	string	Identificador de la petición. Indícalo si escribes a soporte.
`code`	string	Solo en algunos errores: código estable para tratarlo en tu programa.

Cuerpo de error

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Blog no encontrado",
  "requestId": "0b8e2f6c-6d63-4d0e-9c1a-5d8f3c1d7a11"
}

Códigos HTTP

Código	Significado
`400`	Un parámetro no es válido o no existe (por ejemplo `limit=500`, `page=0` o `format=xml`).
`401`	Falta la clave, no es válida o la ruta no admite claves. Ver Autenticación.
`403`	Tu plan no incluye la API o la organización está suspendida.
`404`	El blog o el artículo no existe, no es de tu organización, el identificador está mal formado o el artículo no está publicado.
`429`	Has superado el límite de tu plan. Ver Límites de uso.
`5xx`	Error nuestro. Reintenta con espera creciente.

`code`	HTTP	Cuándo
`plan_required`	403	La organización está en el plan Free.
`ORGANIZATION_SUSPENDED`	403	La organización está suspendida.
`rate_limited`	429	Límite de peticiones superado.