Códigos de Error

Todos los errores HTTP que puede devolver la API

400

400 Bad Request

La solicitud tiene errores de validación o faltan campos requeridos.

Causas comunes:

  • Falta el parámetro 'template'
  • Campos requeridos vacíos
  • URL no usa protocolo HTTPS
  • Email con formato inválido
  • Color no está en formato hexadecimal
  • Texto excede longitud máxima permitida

Ejemplo

Request:

{
  "template": "basic",
  "email": "invalid-email",
  "imageUrl": "http://example.com/image.jpg"
}

Response:

email: Invalid email address
404

404 Not Found

La plantilla solicitada no existe.

Causas comunes:

  • Nombre de plantilla incorrecto
  • Plantillas válidas: basic, promotional, event, certificate, summering

Ejemplo

Request:

{
  "template": "invalid-template"
}

Response:

Template "invalid-template" not found
500

500 Internal Server Error

Error interno del servidor.

Causas comunes:

  • Error al cargar fuentes de Google
  • Error al procesar la imagen
  • Reintenta en unos segundos

Ejemplo

Response:

Error generating preview