Erros e limites

Toda falha tem o mesmo formato:

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

code é estável e pensado para o seu código; message é para pessoas. Alguns erros trazem campos extras, como balance ou diagnostics.

Códigos

Status	code	Quando
400	bad_request	O corpo não é um JSON válido, um campo é inválido, ou template_id e html foram enviados juntos.
401	unauthorized	Sem chave, ou chave errada ou revogada.
402	insufficient_credits	Sem créditos, e o plano não permite mais. balance vem junto.
403	forbidden	Uma requisição de página web que não veio do portal, ou um link de download expirado ou alterado.
404	not_found	O template, a imagem ou o arquivo não existe na sua conta.
409	conflict	Um limite do plano, como o número de templates ou o tamanho total das imagens.
413	payload_too_large	A requisição, um template, os dados ou uma imagem passam de um limite de tamanho.
422	invalid_template	O template não compila ou falha ao gerar, o HTML está aninhado fundo demais, ou o documento tem mais páginas do que o plano permite.
422	strict_mode_rejected	strict foi usado e o documento tem algo não suportado. diagnostics lista o que é.
429	rate_limited	Requisições demais. Espere o tempo do cabeçalho Retry-After.
503	busy	O serviço está ocupado. Espere o tempo do cabeçalho Retry-After e tente de novo.
504	render_timeout	O documento levou mais do que o limite de tempo do seu plano.
500	internal_error	Algo deu errado do nosso lado. Nada é cobrado.

Créditos e falhas

Um crédito é tomado quando uma geração começa e devolvido se ela falhar, por qualquer motivo. Um 402 significa que nada foi gerado.

Tentar de novo

429 e 503 podem ser repetidos com segurança depois do tempo em Retry-After. Respostas 5xx também, porque gerações que falham não custam nada. Não repita erros 4xx sem mudar nada: eles descrevem a requisição.

Limites por plano

O seu plano define a taxa de requisições por chave, a maior entrada, o máximo de páginas por documento, o limite de tempo da geração, quantos templates e quanto espaço de imagens você tem, e por quanto tempo os arquivos gerados ficam guardados. Veja os números em Planos e créditos.