Guia do Programador: Otimizar Chamadas à API Didit para Caching CDN Edge (PT-PT)

Compreender os Limites de TaxaA Didit impõe limites de taxa globais e específicos de endpoint para manter a estabilidade da API, fornecendo cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset para throttling do lado do cliente.

Implementar Backoff ExponencialPara respostas 429, integre uma estratégia de backoff exponencial (por exemplo, 5s → 10s → 20s) para lidar graciosamente com sobrecargas temporárias da API e prevenir violações dos limites de taxa do lado do cliente.

Aproveitar CDN para Ativos EstáticosEmbora a API principal da Didit não possa ser armazenada em cache por CDNs tradicionais, otimize os ativos estáticos da sua aplicação (JS, CSS, imagens) via CDN para reduzir os tempos de carregamento e melhorar o desempenho percebido.

Arquitetura de Desempenho da DiditA infraestrutura nativa de IA e globalmente distribuída da Didit oferece inerentemente baixa latência e alta disponibilidade, tornando-a uma escolha ideal para necessidades de verificação de identidade críticas para o desempenho.

No cenário digital acelerado de hoje, cada milissegundo conta. Para programadores que integram serviços de verificação de identidade, otimizar as chamadas à API para velocidade e eficiência é fundamental. Embora as Redes de Entrega de Conteúdo (CDNs) estejam frequentemente associadas ao armazenamento em cache de ativos estáticos, compreender a melhor forma de interagir com os serviços de API, especialmente aqueles concebidos para operações dinâmicas e em tempo real, como a verificação de identidade, é crucial para o desempenho geral da aplicação. Este guia explora a otimização das suas integrações Didit API, focando-se na limitação de taxa, padrões de chamada eficientes e como a arquitetura da Didit suporta inerentemente o alto desempenho.

Compreender os Limites de Taxa da API da Didit

A Didit, como qualquer serviço de API robusto, implementa limites de taxa para garantir a estabilidade e o uso justo por todos os clientes. Estes limites são críticos para prevenir abusos e manter um desempenho consistente. Compreendê-los e aderir a eles é o primeiro passo para interações otimizadas com a API.

A Didit impõe várias camadas de limitação de taxa:

• Limites Globais: Para endpoints GET gerais, existe um limite de 300 pedidos por minuto por aplicação. Da mesma forma, os endpoints POST, PATCH e DELETE (escrita/eliminação) também têm um teto global de 300 pedidos por minuto por aplicação.
• Limites Específicos de Endpoint: Certas operações de alto impacto têm limites mais restritivos. Por exemplo, POST /v2/session/ (para criar sessões de verificação, frequentemente envolvendo os produtos de Verificação de Identidade ou Estimativa de Idade da Didit) está limitado a 600 pedidos por minuto. A recuperação de decisões de sessão (`GET /v2/session//decision/) é limitada a 100 pedidos por minuto para prevenir polling excessivo, e a geração de PDF (GET /session//generate-pdf/`) também está limitada a 100 pedidos por minuto devido à sua natureza intensiva em CPU.

Quando um limite de taxa é excedido, a API da Didit responde com um código de estado 429 Too Many Requests. Crucialmente, estas respostas incluem cabeçalhos úteis:

• X-RateLimit-Limit: O número máximo de pedidos permitidos.
• X-RateLimit-Remaining: O número de pedidos restantes na janela atual.
• X-RateLimit-Reset: A hora (em segundos epoch) em que a janela de limite de taxa atual é reiniciada.

Ao monitorizar estes cabeçalhos, a sua aplicação pode auto-regular-se proactivamente, prevenindo erros 429 desnecessários e garantindo um fluxo operacional mais suave para serviços como o Rastreio AML ou Deteção de Vida da Didit.

Implementar Throttling e Backoff Inteligentes do Lado do Cliente

O tratamento eficaz do lado do cliente dos limites de taxa é vital para uma integração resiliente. Eis como fazê-lo:

1. Monitorizar Cabeçalhos de Limite de Taxa: Implemente lógica para ler o cabeçalho X-RateLimit-Remaining. Quando este valor cair abaixo de um certo limiar (por exemplo, 15% de X-RateLimit-Limit), o seu cliente deve começar a abrandar a sua taxa de pedidos.

2. Backoff Exponencial para 429s: Esta é uma estratégia crítica. Se a sua aplicação receber uma resposta 429, deve fazer uma pausa antes de tentar novamente o pedido. Em vez de novas tentativas imediatas, implemente um algoritmo de backoff exponencial. Por exemplo, espere 5 segundos, depois 10 segundos, depois 20 segundos, e assim por diante. Isto evita sobrecarregar ainda mais a API e permite que a janela de limite de taxa seja reiniciada. O cabeçalho Retry-After da Didit também pode informar a sua estratégia de backoff.

3. Registar e Alertar: Mantenha um registo de quando os limites de taxa são atingidos e quando as novas tentativas são acionadas. Isto fornece informações valiosas sobre os padrões de uso da sua aplicação e pode ajudar a identificar áreas para otimização ou indicar a necessidade de solicitar um limite superior ao suporte da Didit para casos de uso específicos.

O Papel do Caching CDN Edge no Desempenho da API

Embora as APIs principais de verificação de identidade da Didit, como as de Verificação de Identidade, Correspondência Facial 1:1 ou Verificação NFC, envolvam processamento dinâmico e em tempo real que não pode ser eficazmente armazenado em cache por uma CDN (uma vez que cada pedido é único e requer computação nova), as CDNs ainda desempenham um papel no desempenho geral da sua aplicação.

As CDNs são excelentes no armazenamento em cache de conteúdo estático (imagens, ficheiros JavaScript, CSS, vídeos) em localizações edge mais próximas dos seus utilizadores. Ao servir estes ativos a partir de uma CDN, reduz a carga no seu servidor de origem e diminui a latência para os seus utilizadores. Isto melhora o desempenho percebido da sua aplicação, tornando a experiência geral, incluindo o fluxo de verificação de identidade, muito mais rápida e responsiva.

Por exemplo, se a sua aplicação utiliza um fluxo de trabalho da Didit que envolve uma interface de utilizador baseada na web (por exemplo, para recolher uploads de documentos ou selfies de deteção de vida), os ativos estáticos para essa UI podem ser servidos através de uma CDN. Embora as chamadas à API para o backend da Didit para processar a verificação sejam diretas, a velocidade do ambiente da aplicação circundante afeta significativamente a satisfação do utilizador.

A Arquitetura Nativa de IA da Didit para Desempenho Inigualável

A Didit é construída desde a base como uma plataforma de identidade nativa de IA e orientada para programadores. Esta escolha arquitetónica oferece inerentemente vantagens significativas de desempenho que complementam as suas estratégias de CDN para ativos estáticos:

• Distribuição Global: A infraestrutura da Didit é globalmente distribuída, garantindo baixa latência para os utilizadores, independentemente da sua localização geográfica. Isto significa que as chamadas à API para os endpoints de verificação da Didit são encaminhadas para o centro de dados mais próximo, minimizando o tempo de viagem na rede.
• Otimizado para Tempo Real: Produtos como Deteção de Vida Passiva e Ativa e Correspondência Facial 1:1 são projetados para processamento em tempo real, aproveitando modelos avançados de IA que executam de forma rápida e eficiente.
• Escalabilidade: A arquitetura modular da Didit é construída para escala, capaz de lidar com grandes volumes de pedidos de verificação sem degradação no desempenho, mesmo durante períodos de pico. Isto é crucial para aplicações que exigem alto débito para serviços como Verificação de Telefone e Email ou Comprovativo de Morada.
• APIs Orientadas para Programadores: APIs limpas e bem documentadas garantem que os programadores podem integrar de forma eficiente, reduzindo o tempo de desenvolvimento e o potencial para gargalos de desempenho relacionados com a integração. O processo de registo programático, que requer apenas duas chamadas à API, exemplifica esta abordagem orientada para o programador.

Ao focar-se em práticas de consumo de API eficientes, como o tratamento inteligente de limites de taxa e o backoff exponencial, pode aproveitar ao máximo o backend de alto desempenho e nativo de IA da Didit para proporcionar uma experiência de verificação de identidade contínua e rápida.

Como a Didit Ajuda

A Didit foi concebida para proporcionar uma experiência de verificação de identidade de alto desempenho e fiável. A nossa plataforma nativa de IA oferece uma arquitetura modular, permitindo-lhe integrar primitivos de identidade específicos como Verificação de Identidade (com suporte OCR, MRZ e código de barras), Deteção de Vida Passiva e Ativa, Correspondência Facial 1:1 e Rastreio e Monitorização AML, conforme necessário. Esta modularidade significa que utiliza apenas os recursos de que necessita, otimizando tanto o custo quanto o desempenho. A oferta de KYC Gratuito da Didit, sem taxas de configuração e um modelo de pagamento por verificação bem-sucedida, torna incrivelmente acessível começar. A nossa infraestrutura distribuída globalmente garante que as suas chamadas à API beneficiam de baixa latência e alta disponibilidade, tornando a necessidade de caching CDN tradicional de respostas de API menos relevante, uma vez que a natureza dinâmica da verificação de identidade exige processamento em tempo real. Capacitamos os programadores com uma solução robusta e escalável que inerentemente prioriza a velocidade e a eficiência, permitindo-lhe focar-se na construção de excelentes aplicações enquanto nós tratamos das complexidades da confiança na identidade.

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.