Catálogo de erros - SuperSign

Decida pelo status HTTP e por error.code; error.message é destinado ao diagnóstico humano e pode evoluir.

Código	HTTP esperado	Como tratar
`INVALID_API_KEY`	`401`	Confira ambiente, prefixo, revogação e header `Authorization`.
`RESOURCE_NOT_FOUND`	`404`	Confira o identificador e o vínculo do recurso com a conta.
`RATE_LIMIT_EXCEEDED`	`429`	Respeite `Retry-After` e repita com backoff e jitter.
`IDEMPOTENCY_KEY_REQUIRED`	`400`	Envie `Idempotency-Key` em toda operação `POST`.
`IDEMPOTENCY_KEY_IN_USE`	`409`	Aguarde e repita a mesma requisição com a mesma chave.
`IDEMPOTENCY_KEY_REUSE`	`422`	Não reutilize a chave com rota ou corpo diferente.
`IDEMPOTENCY_UNAVAILABLE`	`503`	Repita com backoff sem trocar a chave.
`ENVELOPE_WRITE_NOT_ALLOWED`	`403`	O envelope não permite essa alteração para o ator ou estado atual.
`DOCUMENT_TOO_LARGE`	`413`	Reduza o arquivo conforme o limite informado pela resposta.
`VERSION_UNAVAILABLE`	`403`	A versão solicitada do documento não está disponível para download.
`CONTACT_ALREADY_EXISTS`	`409`	Consulte ou atualize o contato existente.
`FOLDER_SELF_MOVE`	`400`	Não mova uma pasta para ela mesma.
`FOLDER_CIRCULAR_MOVE`	`400`	Escolha um destino fora da árvore descendente da pasta.
`NON_EMPTY_FOLDER`	`403`	Remova ou mova o conteúdo antes de excluir a pasta.

Falhas 5xx, 429, timeout e erros de rede podem ser transitórios. Em operações POST, preserve a mesma Idempotency-Key durante toda a tentativa lógica.