Como usar
- Defina o objetivo da integração e os recursos necessários antes de criar uma credencial.
- Em Chaves de API, configure os escopos disponíveis para a empresa e preserve o segredo apenas no servidor autorizado.
- Teste autenticação e uma consulta de leitura. Registre somente a identificação da requisição, o estado e um exemplo de resposta sem dados pessoais.
- Para webhooks, valide autenticidade, reentregas e idempotência antes de executar escritas.
- Teste uma operação de escrita somente em ambiente autorizado, confira o resultado no produto e estabeleça plano de revogação da credencial.
Pratique com segurança
Ensaiar idempotência
O provedor repete um evento depois de uma falha de rede.
- Envie o mesmo evento de teste duas vezes.
- Compare os recibos e as alterações persistidas.
- Verifique que apenas uma ação de negócio foi materializada.
Resultado esperado: O sistema registra a repetição sem executar duas vezes o mesmo efeito.
Como conferir o resultado
- Requisições de leitura respeitam o escopo configurado.
- Operações mutáveis são rastreáveis e não se duplicam após reentregas.
Limites e cuidados
- Uma resposta HTTP de aceitação não garante que a ação assíncrona terminou.
- Nunca exponha chaves em captura de tela, código cliente ou chamados.
- MCP e API REST podem oferecer diferentes conjuntos de ferramentas e aprovações.