Errores y límites

Todo fallo tiene el mismo formato:

{
  "error": {
    "code": "insufficient_credits",
    "message": "This account has no credits left. Upgrade the plan or wait for the next period.",
    "balance": 0
  }
}

code es estable y está pensado para tu código; message es para personas. Algunos errores traen campos adicionales, como balance o diagnostics.

Códigos

Estado	code	Cuándo
400	bad_request	El cuerpo no es un JSON válido, un campo es inválido, o se enviaron template_id y html a la vez.
401	unauthorized	Sin clave, o clave errónea o revocada.
402	insufficient_credits	Sin créditos, y el plan no permite más. Incluye balance.
403	forbidden	Una petición de página web que no vino del portal, o un enlace de descarga caducado o alterado.
404	not_found	La plantilla, la imagen o el archivo no existe en tu cuenta.
409	conflict	Un límite del plan, como el número de plantillas o el tamaño total de las imágenes.
413	payload_too_large	La petición, una plantilla, los datos o una imagen superan un límite de tamaño.
422	invalid_template	La plantilla no compila o falla al generar, el HTML está anidado demasiado hondo, o el documento tiene más páginas de las que permite el plan.
422	strict_mode_rejected	Se usó strict y el documento tiene algo no admitido. diagnostics lista qué es.
429	rate_limited	Demasiadas peticiones. Espera el tiempo de la cabecera Retry-After.
503	busy	El servicio está ocupado. Espera el tiempo de la cabecera Retry-After y vuelve a intentarlo.
504	render_timeout	El documento tardó más que el límite de tiempo de tu plan.
500	internal_error	Algo salió mal por nuestra parte. No se cobra nada.

Créditos y fallos

Un crédito se toma cuando empieza una generación y se devuelve si falla, por el motivo que sea. Un 402 significa que no se generó nada.

Reintentar

429 y 503 se pueden repetir con seguridad pasado el tiempo de Retry-After. Las respuestas 5xx también, porque las generaciones que fallan no cuestan nada. No repitas los errores 4xx sin cambiar nada: describen la petición.

Límites por plan

Tu plan define la tasa de peticiones por clave, la mayor entrada, el máximo de páginas por documento, el límite de tiempo de la generación, cuántas plantillas y cuánto espacio de imágenes tienes, y durante cuánto tiempo se conservan los archivos generados. Consulta las cifras en Planes y créditos.