Lide com erros e repetições da API

Inspecione sempre o status HTTP antes de ler uma resposta como sucesso. Os serviços ShareAI podem retornar diferentes envelopes de erro: inferência pode fornecer error.code, OAuth fornece error and error_description, e as rotas do Console podem retornar code, message and data.status.

Status	Significado típico	Recuperação
200 com um objeto de erro	Resultado de indisponibilidade de dispositivo no endpoint de chat atual.	Inspecione error.code e não o apresente como uma resposta do assistente.
400	Pedido inválido ou concessão OAuth inválida.	Corrija o corpo, os parâmetros, o callback ou o código expirado/consumido.
401	Autenticação ausente, expirada ou inválida.	Verifique as credenciais; atualize apenas uma concessão OAuth válida.
402	Créditos insuficientes ou saldo aplicável.	Verifique o saldo da conta selecionada antes de tentar novamente.
403	Negação de âmbito, propriedade, função ou estado habilitado.	Verifique o limite de permissões documentado.
404	Recurso desconhecido ou rota de gateway não suportada.	Verifique o host, o caminho e os identificadores de recurso.
409	Conflito de estado ou revisão.	Leia o estado atual e reconsidere a alteração.
429	Limite de solicitação ou concorrência.	Respeite Retry-After e use um backoff limitado.
500 / 502 / 503	Falha de disponibilidade do servidor ou upstream.	Mantenha as tentativas limitadas; preserve os identificadores de diagnóstico.

Refaça leituras com um limite#

Para falhas temporárias em leituras, aguarde com atraso e jitter crescentes, respeite Retry-After quando presente e pare após um número definido de tentativas ou limite de tempo. Mostre ao utilizador quando os dados não estão disponíveis em vez de repetir silenciosamente.

Trate gravações com cuidado#

Não repita automaticamente uma atualização de preços, criação de modelo ou comando de partilha quando o resultado for desconhecido. Leia primeiro o estado do recurso ou comando. Use uma Idempotency-Key apenas em endpoints que documentem suporte, como alterações de acordos.

Tokens de atualização são de uso único#

A rotação de atualização requer um bloqueio por autorização no seu backend. Uma tentativa cega de reutilizar um token de atualização consumido pode revogar a concessão. Veja atualização segura de token.

O que incluir num pedido de suporte#

Inclua o endpoint, status HTTP, código de erro, hora e identificador de resposta/tarefa quando disponível. Remova cabeçalhos de autorização, cookies, segredos do cliente, tokens de acesso, tokens de atualização e conteúdos privados de prompts.