Tratamento de erros
Leia o status HTTP junto com o corpo da resposta. Os campos de erro variam por endpoint; consulte o contrato exato na referência da API.
- Em caso de timeout ou falha 5xx temporária, consulte primeiro qualquer ID de conteúdo ou trabalho recebido. Para repetir a mesma operação, mantenha o mesmo conteúdo e idempotency_key e limite as tentativas com espera progressiva. HTTP 202 significa aceitação, não publicação bem-sucedida.
- Para 409 idempotency_conflict, compare a solicitação original e seu resultado. Não gere uma nova chave automaticamente. Use outra chave apenas para uma operação intencionalmente nova, após verificar a anterior.
- Corrija dados inválidos ou falhas de autenticação e permissão antes de tentar novamente. Para 429, confira o erro e Retry-After, se presente: cotas esgotadas podem exigir renovação da cota ou mudança de plano, não uma espera curta.
{ "error": "insufficient_scope", "message": "publishing:write scope is required for this API request."}