Erros

A REST API usa códigos de status HTTP padrão e retorna um corpo JSON de erro:

json

{ "error": "unauthorized", "message": "Missing or invalid API key" }

# Códigos de status

Status	`error`	Quando
`400`	`invalid-argument`	Corpo malformado ou campo obrigatório ausente.
`401`	`unauthorized`	Chave de API ausente, inválida ou revogada.
`403`	`forbidden` / `failed-precondition`	Além do permitido pelo seu plano (p.ex. criação de códigos serializados sem Enterprise, ou acima de uma cota). O limite está na mensagem.
`404`	`not-found`	Nenhum link/campanha/job com esse id, ou não pertence à sua conta.
`429`	`rate-limited`	Limite de taxa por chave excedido — recue e tente novamente.
`5xx`	`internal`	Algo deu errado do nosso lado; seguro tentar novamente para leituras idempotentes.

# Propriedade

Toda leitura e escrita está vinculada à conta que a chave de API resolve. Solicitar um link ou campanha de outra conta retorna 404 (não 403) — não revelamos que existe.

# Jobs assíncronos

Jobs de Lote e criação de serialização aceitam a requisição (200, queued), então surfam falhas no status do job (status: "failed" com um motivo), não na resposta HTTP original. Sempre pesquise o job.

# Verificação

Os endpoints de verificação públicos nunca erram em um serial desconhecido — eles retornam status: "unknown" (um código falso/não-emitido é uma resposta significativa, não um 404).

# Próximo

Authentication · a referência completa da API.