Ir al contenido

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.

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.

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.

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.

Tu plan define la tasa de peticiones de la cuenta, compartida por todas sus claves, 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.