Clientes API Idempotentes para Verificação de Identidade Confiável (PT-BR)

Garanta a Consistência dos Dados Implemente chamadas de API idempotentes para garantir que solicitações repetidas de verificação de identidade não levem a resultados múltiplos, conflitantes ou errôneos, mantendo a integridade dos dados.

Mitigue Falhas de Rede Projete seu cliente para lidar com falhas de rede transitórias de forma elegante, repetindo operações com segurança sem efeitos colaterais indesejados, melhorando a resiliência do sistema.

Evite Ações Duplicadas Utilize chaves de idempotência únicas para cada solicitação, permitindo que a API reconheça e responda adequadamente a solicitações repetidas, prevenindo o processamento duplo de sessões de verificação.

Simplifique a Integração com a Didit A API da Didit foi construída com a idempotência em mente, oferecendo uma experiência focada no desenvolvedor que naturalmente suporta retentativas confiáveis para Verificação de Identidade, Prova de Vida e Triagem AML, simplificando seu processo de integração.

O Desafio dos Sistemas Distribuídos e da Verificação de Identidade

No cenário digital interconectado de hoje, a verificação de identidade é a pedra angular da confiança e segurança. Desde a integração de novos usuários até o cumprimento das regulamentações AML, as empresas dependem muito de soluções de identidade baseadas em API. No entanto, a própria natureza dos sistemas distribuídos — com suas latências de rede inerentes, tempos limite e potencial para indisponibilidade temporária de serviço — introduz um desafio significativo: como garantir que uma operação, como o início de uma verificação de identidade, seja processada exatamente uma vez, mesmo que a solicitação seja enviada várias vezes?

Sem um design cuidadoso, uma simples falha na rede pode levar um cliente a repetir uma solicitação, fazendo com que o sistema de verificação processe o documento de identidade ou a verificação de prova de vida do mesmo usuário várias vezes. Isso não apenas desperdiça recursos, mas também pode levar a estados inconsistentes, complicar a auditoria e degradar a experiência do usuário. É aqui que o conceito de idempotência se torna crítico.

O que é Idempotência e Por que Ela é Importante para KYC?

Uma operação é idempotente se a execução dela várias vezes produzir o mesmo resultado que a execução uma única vez. No contexto de chamadas de API, uma solicitação idempotente significa que, se você enviar a mesma carga de solicitação com a mesma chave de idempotência repetidamente, o servidor a processará apenas uma vez, e as solicitações idênticas subsequentes retornarão o resultado original sem reexecutar a ação subjacente.

Para os processos de Know Your Customer (KYC) e verificação de identidade, a idempotência é primordial:

• Prevenção de Verificações Duplicadas: Imagine que um usuário tenta verificar sua identidade, mas um erro de rede impede que seu sistema receba a resposta de sucesso. Sem idempotência, uma nova tentativa pode iniciar uma segunda sessão de Verificação de Identidade idêntica, levando a trabalho redundante e possíveis cobranças.
• Garantia de Estado Consistente: Se uma verificação de Triagem AML for iniciada e a resposta for perdida, uma nova tentativa com um cliente idempotente garante que o status de triagem original seja retornado, em vez de acionar uma nova triagem, potencialmente diferente.
• Simplificação do Tratamento de Erros: Os desenvolvedores podem implementar uma lógica de nova tentativa robusta sem medo de efeitos colaterais indesejados, tornando sua integração mais resiliente e fácil de depurar.

Projetando um Cliente API Idempotente

Para construir um cliente API idempotente para verificação de identidade, você precisa aproveitar as chaves de idempotência. São tokens únicos, gerados pelo cliente, que acompanham cada solicitação. O servidor usa essa chave para detectar solicitações duplicadas dentro de um período específico (por exemplo, 24 horas).

1. Gere Chaves de Idempotência Únicas

Para cada operação lógica única que você realiza (por exemplo, criar uma nova sessão de verificação para um usuário específico), gere uma chave de idempotência única. Um UUID (Identificador Universalmente Único) é uma excelente escolha para isso. Esta chave deve ser associada à ação específica que você deseja que seja idempotente.

Exemplo: Ao iniciar uma nova sessão de Verificação de Identidade para user_id_123, gere idempotency_key_abc.

2. Inclua a Chave de Idempotência nas Solicitações

A maioria das APIs que suportam idempotência esperará um cabeçalho específico, frequentemente Idempotency-Key, ou um campo dentro do corpo da solicitação. Certifique-se de que seu cliente inclua consistentemente esta chave para todas as solicitações relevantes, particularmente aquelas que criam ou modificam recursos.

3. Implemente uma Lógica Robusta de Nova Tentativa

Quando ocorre um erro transitório (por exemplo, um erro de servidor 5xx, tempo limite de rede), seu cliente deve repetir a solicitação usando a mesma chave de idempotência. O "exponential backoff with jitter" é uma estratégia comum para espaçar as novas tentativas e evitar sobrecarregar o servidor.

Considere a API 'Create Session' para o Business Console da Didit. Se você estiver criando um link de verificação via API, pode enviar uma solicitação POST para /v3/session/. Se esta solicitação expirar, você pode tentar novamente com a mesma chave de idempotência. A API Didit reconhecerá a chave e, se uma sessão já foi criada com sucesso, simplesmente retornará os detalhes da sessão existente, evitando uma duplicata. Isso é crucial para produtos como a Verificação de Identidade da Didit e as verificações de Prova de Vida Passiva e Ativa.

4. Armazene e Gerencie as Chaves de Idempotência

Seu aplicativo cliente precisa armazenar a chave de idempotência junto com o estado da operação. Isso permite que você recupere a chave correta se uma nova tentativa for necessária. Certifique-se de que a chave seja armazenada persistentemente se o aplicativo puder falhar ou reiniciar entre a solicitação inicial e uma possível nova tentativa.

Além da Idempotência: Aumentando a Confiabilidade com Webhooks

Embora a idempotência lide com novas tentativas de forma eficaz, um sistema verdadeiramente confiável também incorpora webhooks. A Didit, por exemplo, envia atualizações automatizadas para sua URL de webhook configurada à medida que o usuário avança em um fluxo de verificação e quando o resultado final está pronto. Este sistema de notificação baseado em push complementa a idempotência, fornecendo atualizações de status definitivas, reduzindo a necessidade de seu cliente fazer polling na API e aumentando ainda mais a resiliência do sistema.

Ao combinar um cliente idempotente com notificações de webhook, você obtém uma integração altamente robusta: seu cliente pode repetir solicitações com segurança, e seu sistema recebe atualizações em tempo real sobre os resultados da verificação para produtos como Triagem e Monitoramento AML e Comprovante de Endereço, mesmo que as respostas iniciais da API sejam perdidas.

Como a Didit Ajuda

A Didit é projetada desde o início para suportar integrações altamente confiáveis e idempotentes, tornando-a uma escolha ideal para empresas que priorizam a robustez e a experiência do desenvolvedor. Nossa plataforma nativa de IA oferece uma arquitetura modular, permitindo que você componha fluxos de verificação com facilidade, e nossas APIs são construídas com a idempotência em mente.

Quando você cria uma sessão para a Verificação de Identidade da Didit, Prova de Vida Passiva e Ativa, Correspondência Facial 1:1 ou Triagem AML, nosso sistema lida inerentemente com a idempotência dessas solicitações de criação. Isso significa que sua equipe de desenvolvimento pode se concentrar na construção de seu produto principal, sabendo que as chamadas de criação de sessão de nova tentativa não levarão a verificações duplicadas não intencionais ou cobranças errôneas. O compromisso da Didit com uma abordagem focada no desenvolvedor inclui o fornecimento de documentação abrangente e APIs limpas que simplificam a implementação de mecanismos de nova tentativa resilientes. Além disso, com o KYC Core Gratuito da Didit, você pode implementar essas soluções robustas sem custos iniciais, pagando apenas por verificação bem-sucedida. Nosso modelo sem taxa de configuração e recursos nativos de IA garantem que seus processos de verificação de identidade não sejam apenas confiáveis, mas também eficientes e escaláveis.

Pronto para Começar?

Pronto para ver a Didit em ação? Obtenha uma demonstração gratuita hoje.

Comece a verificar identidades gratuitamente com o nível gratuito da Didit.