Erros

Todos os endpoints devolvem erros num destes dois formatos:

{ "error": "mensagem descritiva do erro" }

{ "errors": ["lista de erros de validação"] }

POST /emails usa o formato de lista (errors) para erros de validação (400). Todos os outros endpoints usam o formato singular (error).

Códigos de estado

Código	Significado	Quando acontece
`200`	OK	Leitura bem-sucedida (ex: URL de download gerada)
`201`	Criado	Email enviado, ou presigned URL de upload gerada
`400`	Pedido inválido	Campo obrigatório em falta ou inválido
`401`	Não autorizado	`x-api-key` em falta, inválida ou revogada
`404`	Não encontrado	Ficheiro inexistente no S3
`422`	Não processável	Email rejeitado pelo SES — domínio do `from` não verificado, ou (em Sandbox) destinatário não verificado
`500`	Erro interno	Falha inesperada no servidor
`503`	Serviço indisponível	Envio pausado pelo SES

Um 401 acontece sempre que a API key está em falta, é inválida, ou foi revogada — nunca assumas que uma chave que funcionou ontem continua válida hoje sem tratar este caso no teu código.

Um 422 em POST /emails normalmente significa que o domínio do from ainda não está verificado — confirma o estado em Settings → Domains no workspace antes de reenviar.

AnexosUpload directo para S3 e referência do ficheiro num email.

⌘I

Começar

Guias

Essenciais

Códigos de estado

​Códigos de estado

Códigos de estado