Padrao de erro

Copiar

Codigos HTTP comuns

• 400 payload invalido ou campos obrigatorios ausentes
• 401 API key invalida ou nao informada
• 403 escopo insuficiente
• 404 recurso nao encontrado
• 500 falha interna

Exemplos de erro

API key invalida

Copiar

Payload invalido

Copiar

Boas praticas

• Use HTTPS em todas as requisicoes
• Guarde a API key em cofre/secret manager
• Restrinja escopos ao minimo necessario
• Valide a assinatura HMAC nos webhooks
• Registre metadata.eventId para deduplicacao
• Armazene X-LIP-Attempt para auditoria de retries

Tratamento de retries (webhooks)

• Responda 2xx somente quando o processamento for bem-sucedido
• Responda 4xx/5xx para forcar nova tentativa
• Implemente idempotencia usando metadata.eventId

Observabilidade

• Salve messageId e conversationId ao enviar mensagens
• Logue X-LIP-Event, X-LIP-Timestamp e X-LIP-Attempt