Error Codes

All HTTP errors the API can return

400

400 Bad Request

The request has validation errors or missing required fields.

Common causes:

  • •Missing 'template' parameter
  • •Empty required fields
  • •URL doesn't use HTTPS protocol
  • •Invalid email format
  • •Color not in hexadecimal format
  • •Text exceeds maximum allowed length

Example

Request:

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

Response:

email: Invalid email address
404

404 Not Found

The requested template does not exist.

Common causes:

  • •Incorrect template name
  • •Valid templates: basic, promotional, event, certificate, summering

Example

Request:

{
  "template": "invalid-template"
}

Response:

Template "invalid-template" not found
500

500 Internal Server Error

Internal server error.

Common causes:

  • •Error loading Google fonts
  • •Error processing image
  • •Retry in a few seconds

Example

Response:

Error generating preview