Interprete o resultado da operação
O status HTTP e o corpo da resposta descrevem a operação chamada. Eles nem sempre significam que uma pessoa recebeu uma mensagem.
A referência de cada operação continua sendo a fonte do contrato: mensagens, liberação, transferência e Custom Connections.
Um ID de correlação não é uma URL de consulta de status. O contrato publicado não define um endpoint de consulta periódica para
trackingId ou requestId. Guarde-o para correlação e suporte; não construa um novo endpoint a partir dele.Leia o formato de erro publicado pelo endpoint
A API REST de integrações e Custom Connections têm contratos de erro separados.API REST de integrações
Muitas respostas usamProblem: title e status são obrigatórios; code, detail, errors, traceId, instance e extra são opcionais. Quando code estiver presente, use-o para selecionar o tratamento de erro documentado, em vez de comparar o texto de title. Guarde traceId, quando fornecido, para pedir suporte.
Algumas respostas de validação publicadas declaram HTTPValidationError, cujo detail é um array de entradas com loc, msg e type. Já o tratador compartilhado de erros da API revisado para esta documentação retorna os detalhes de validação em Problem.errors[]. As definições publicadas de resposta foram preservadas; a confirmação na API implantada ainda está pendente. Veja a nota de compatibilidade de validação.
Aceite erros JSON tanto com application/json quanto com application/problem+json. Examine code, quando presente, e depois um array errors ou detail para os erros de campo. Um detail do tipo string é uma explicação, não um array. O status 422 sozinho não define um formato universal de corpo. Mantenha um tratamento alternativo para erros sem code e use a referência do endpoint junto com códigos de erro para escolher a ação.
Custom Connections
Seu corpo de erro contémtype, title e status obrigatórios e pode incluir detail. Nesse contrato, type é o identificador de erro legível por máquina. Ele não é o campo REST code. A referência de erros de Custom Connections lista essas respostas.
As respostas de erro não contêm o requestId do envio; somente uma resposta bem-sucedida 202 contém esse valor. Para pedir suporte sobre um erro, guarde a URL da página e o horário aproximado, conforme a referência.
Decida se deve tentar novamente por operação e causa
Veja limites de requisições para controlar o ritmo e erros de Custom Connections para suas regras específicas de nova tentativa.
Algumas falhas podem ocorrer depois de uma gravação
A referência de outbound de Agente documenta que umtemplate.media.mediaId desconhecido pode produzir BRIDGE_AI_LEADSCOUT_0016 depois que a conversa já foi criada ou recuperada. Por isso, uma nova tentativa pode produzir um resultado diferente.
Um status de falha, portanto, não é uma garantia universal de rollback. Siga os efeitos e as instruções de recuperação da operação específica. Se essas instruções forem pouco claras ou conflitantes, identifique a incerteza e entre em contato com o suporte do Bridge antes de repetir uma ação com efeitos externos.