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

Garanta a Consistência dos DadosImplemente chamadas de API idempotentes para garantir que pedidos repetidos de verificação de identidade não resultem em múltiplos, conflituosos ou erróneos resultados, mantendo a integridade dos dados.

Atenue Falhas de RedeDesenhe o seu cliente para lidar graciosamente com falhas de rede transitórias, repetindo operações de forma segura sem efeitos secundários indesejados, melhorando a resiliência do sistema.

Previna Ações DuplicadasUtilize chaves de idempotência únicas para cada pedido, permitindo que a API reconheça e responda apropriadamente a pedidos repetidos, prevenindo o processamento duplicado de sessões de verificação.

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

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

No panorama digital interligado de hoje, a verificação de identidade é um pilar de confiança e segurança. Desde o registo de novos utilizadores até ao cumprimento das regulamentações de AML, as empresas dependem fortemente de soluções de identidade baseadas em API. No entanto, a própria natureza dos sistemas distribuídos — com as suas latências de rede inerentes, tempos limite e potencial para indisponibilidade temporária do serviço — introduz um desafio significativo: como garantir que uma operação, como iniciar uma verificação de identidade, é processada exatamente uma vez, mesmo que o pedido seja enviado várias vezes?

Sem um design cuidadoso, um simples problema de rede pode levar um cliente a repetir um pedido, fazendo com que o sistema de verificação processe o mesmo documento de identificação ou verificação de prova de vida do utilizador várias vezes. Isto não só desperdiça recursos, como também pode levar a estados inconsistentes, complicar a auditoria e degradar a experiência do utilizador. É aqui que o conceito de idempotência se torna crítico.

O Que é Idempotência e Por Que É Importante para o KYC?

Uma operação é idempotente se a sua execução várias vezes produzir o mesmo resultado que a sua execução uma única vez. No contexto das chamadas de API, um pedido idempotente significa que, se enviar o mesmo payload de pedido com a mesma chave de idempotência repetidamente, o servidor irá processá-lo apenas uma vez, e os pedidos idênticos subsequentes devolverão o resultado original sem reexecutar a ação subjacente.

Para os processos de Conheça o Seu Cliente (KYC) e verificação de identidade, a idempotência é primordial:

• Prevenção de Verificações Duplicadas: Imagine que um utilizador tenta verificar a sua identidade, mas um erro de rede impede o seu sistema de receber a resposta de sucesso. Sem idempotência, uma retentativa pode iniciar uma segunda sessão de Verificação de Identidade idêntica, levando a trabalho redundante e potenciais custos.
• Garantia de Estado Consistente: Se uma verificação de Rastreio de AML for iniciada e a resposta for perdida, uma retentativa com um cliente idempotente garante que o estado de rastreio original é devolvido, em vez de desencadear um novo rastreio, potencialmente diferente.
• Simplificação do Tratamento de Erros: Os programadores podem implementar uma lógica de retentativa robusta sem medo de efeitos secundários indesejados, tornando a sua integração mais resiliente e mais fácil de depurar.

Desenhar um Cliente de API Idempotente

Para construir um cliente de API idempotente para verificação de identidade, é necessário utilizar chaves de idempotência. São tokens únicos, gerados pelo cliente, que acompanham cada pedido. O servidor usa esta chave para detetar pedidos duplicados dentro de um período de tempo específico (por exemplo, 24 horas).

1. Gerar Chaves de Idempotência Únicas

Para cada operação lógica única que executa (por exemplo, criar uma nova sessão de verificação para um utilizador 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 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. Incluir a Chave de Idempotência nos Pedidos

A maioria das APIs que suportam idempotência espera um cabeçalho específico, frequentemente Idempotency-Key, ou um campo dentro do corpo do pedido. Certifique-se de que o seu cliente inclui consistentemente esta chave para todos os pedidos relevantes, particularmente aqueles que criam ou modificam recursos.

3. Implementar Lógica de Retentativa Robusta

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

Considere a API 'Create Session' para a Consola Empresarial da Didit. Se estiver a criar um link de verificação via API, poderá enviar um pedido 'POST' para /v3/session/. Se este pedido exceder o tempo limite, pode repeti-lo com a mesma chave de idempotência. A API da Didit reconhecerá a chave e, se uma sessão já tiver sido criada com sucesso, simplesmente devolverá os detalhes da sessão existente, evitando uma duplicação. Isto é crucial para produtos como a Verificação de Identidade da Didit e as verificações de Prova de Vida Passiva e Ativa.

4. Armazenar e Gerir Chaves de Idempotência

A sua aplicação cliente precisa de armazenar a chave de idempotência juntamente com o estado da operação. Isto permite-lhe recuperar a chave correta se for necessária uma retentativa. Certifique-se de que a chave é armazenada de forma persistente caso a aplicação possa falhar ou reiniciar entre o pedido inicial e uma potencial retentativa.

Além da Idempotência: Aumentar a Fiabilidade com Webhooks

Embora a idempotência lide eficazmente com as retentativas, um sistema verdadeiramente fiável também incorpora webhooks. A Didit, por exemplo, envia atualizações automáticas para o seu URL de webhook configurado à medida que o utilizador avança num fluxo de verificação e quando o resultado final está pronto. Este sistema de notificação "push" complementa a idempotência, fornecendo atualizações de estado definitivas, reduzindo a necessidade de o seu cliente sondar a API e melhorando ainda mais a resiliência do sistema.

Ao combinar um cliente idempotente com notificações de webhook, alcança uma integração altamente robusta: o seu cliente pode repetir pedidos com segurança, e o seu sistema recebe atualizações em tempo real sobre os resultados da verificação para produtos como o Rastreio e Monitorização de AML e a Prova de Morada, mesmo que as respostas iniciais da API sejam perdidas.

Como a Didit Ajuda

A Didit foi concebida desde o início para suportar integrações altamente fiáveis e idempotentes, tornando-a uma escolha ideal para empresas que priorizam a robustez e a experiência do programador. A nossa plataforma baseada em IA oferece uma arquitetura modular, permitindo-lhe compor fluxos de trabalho de verificação com facilidade, e as nossas APIs são construídas com a idempotência em mente.

Quando cria uma sessão para a Verificação de Identidade, Prova de Vida Passiva e Ativa, Correspondência Facial 1:1 ou Rastreio de AML da Didit, o nosso sistema lida inerentemente com a idempotência desses pedidos de criação. Isso significa que a sua equipa de desenvolvimento pode focar-se na construção do seu produto principal, sabendo que a repetição de chamadas de criação de sessão não levará a verificações duplicadas não intencionais ou a custos erróneos. O compromisso da Didit com uma abordagem "developer-first" inclui o fornecimento de documentação abrangente e APIs limpas que simplificam a implementação de mecanismos de retentativa resilientes. Além disso, com o KYC Core Gratuito da Didit, pode implementar estas soluções robustas sem custos iniciais, pagando apenas por cada verificação bem-sucedida. O nosso modelo sem taxas de configuração e as capacidades nativas de IA garantem que os seus processos de verificação de identidade não são apenas fiá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.