Erros - Kourio

Todo erro tem a mesma forma:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Marketing email accepts a single recipient per message",
    "details": [{ "path": "to", "message": "…" }],
    "requestId": "bac1da95-c96e-4e1f-82b8-b9d7…"
  }
}

Cite o requestId. Ele é o que nos deixa achar a sua requisição exata no log em segundos, em vez de procurar por horário e endereço. Guarde-o quando registrar a falha do seu lado.

Os que mais aparecem

Código	O que houve	O que fazer
`VALIDATION_ERROR`	O corpo não passou no esquema	Leia `details`, que aponta o campo
`DOMAIN_NOT_VERIFIED`	O `from` não está num domínio seu verificado	Publique o DNS e chame `verify`
`QUOTA_EXCEEDED`	A cota do mês acabou	O `Retry-After` diz quantos segundos até virar
`MARKETING_SENDING_UNAVAILABLE`	Marketing está fechado nesta conta	Fale com a gente
`SUPPRESSED_RECIPIENT`	O endereço está na lista de supressão	Não force; veja por que ele entrou

Repetir com segurança

Mande Idempotency-Key no envio. Se a resposta se perder no caminho, repetir a chamada com a mesma chave devolve o envio original em vez de mandar a mensagem duas vezes.

curl -X POST https://kourio.app/v1/emails \
  -H "Authorization: Bearer $KOURIO_API_KEY" \
  -H "Idempotency-Key: pedido-A-10428-confirmacao" \
  -H "Content-Type: application/json" \
  -d '{ "from": "…", "to": "…", "subject": "…", "html": "…" }'