Guia do Desenvolvedor: Otimizando Chamadas da API Didit para Cache de Borda CDN (PT-BR)

Entenda 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.

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

Aproveite o 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 de 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 desenvolvedores que integram serviços de verificação de identidade, otimizar as chamadas de API para velocidade e eficiência é primordial. Embora as Redes de Entrega de Conteúdo (CDNs) sejam frequentemente associadas ao cache de ativos estáticos, entender como interagir melhor com os serviços de API, especialmente aqueles projetados 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 de suas integrações da API Didit, focando na limitação de taxa, padrões de chamada eficientes e como a arquitetura da Didit suporta intrinsecamente alto desempenho.

Entendendo os Limites de Taxa da API Didit

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

A Didit impõe múltiplas camadas de limitação de taxa:

• Limites Globais: Para endpoints GET gerais, há um limite de 300 requisições por minuto por aplicação. Similarmente, endpoints POST, PATCH e DELETE (escrita/exclusão) também têm um teto global de 300 requisições 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 ID ou Estimativa de Idade da Didit) é limitado a 600 requisições por minuto. A recuperação de decisões de sessão (`GET /v2/session//decision/) é limitada a 100 requisições por minuto para evitar polling excessivo, e a geração de PDF (GET /session//generate-pdf/`) também é limitada a 100 requisições por minuto devido à sua natureza intensiva em CPU.

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

• X-RateLimit-Limit: O número máximo de requisições permitidas.
• X-RateLimit-Remaining: O número de requisições restantes na janela atual.
• X-RateLimit-Reset: O tempo (em segundos epoch) quando a janela de limite de taxa atual é redefinida.

Ao monitorar esses cabeçalhos, sua aplicação pode se auto-limitar proativamente, prevenindo erros 429 desnecessários e garantindo um fluxo operacional mais suave para serviços como o AML Screening ou Detecção de Vivacidade da Didit.

Implementando Throttling e Backoff Inteligentes no Lado do Cliente

O tratamento eficaz dos limites de taxa no lado do cliente é vital para uma integração resiliente. Veja como fazer:

1. Monitore os 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 limite (ex: 15% de X-RateLimit-Limit), seu cliente deve começar a diminuir sua taxa de requisições.

2. Backoff Exponencial para 429s: Esta é uma estratégia crítica. Se sua aplicação receber uma resposta 429, ela deve pausar antes de tentar novamente a requisição. 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. Isso evita sobrecarregar ainda mais a API e permite que a janela de limite de taxa seja redefinida. O cabeçalho Retry-After da Didit também pode informar sua estratégia de backoff.

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

O Papel do Cache de Borda CDN no Desempenho da API

Embora as APIs de verificação de identidade da Didit, como as para Verificação de ID, 1:1 Face Match ou Verificação NFC, envolvam processamento dinâmico e em tempo real que não pode ser efetivamente armazenado em cache por um CDN (já que cada requisição é única e exige nova computação), os CDNs ainda desempenham um papel no desempenho geral de sua aplicação.

Os CDNs se destacam no cache de conteúdo estático (imagens, arquivos JavaScript, CSS, vídeos) em locais de borda mais próximos aos seus usuários. Ao servir esses ativos de um CDN, você reduz a carga em seu servidor de origem e diminui a latência para seus usuários. Isso melhora o desempenho percebido de sua aplicação, fazendo com que a experiência geral, incluindo o fluxo de verificação de identidade, pareça muito mais rápida e responsiva.

Por exemplo, se sua aplicação usa um fluxo de trabalho Didit que envolve uma interface de usuário baseada na web (ex: para coletar uploads de documentos ou selfies de detecção de vivacidade), os ativos estáticos para essa interface de usuário podem ser servidos via CDN. Embora as chamadas de API para o backend da Didit para processar a verificação sejam diretas, a velocidade do ambiente da aplicação circundante impacta significativamente a satisfação do usuário.

Arquitetura Nativa de IA da Didit para Desempenho Inigualável

A Didit foi construída desde o início como uma plataforma de identidade nativa de IA e focada no desenvolvedor. Essa escolha arquitetônica oferece inerentemente vantagens significativas de desempenho que complementam suas estratégias de CDN para ativos estáticos:

• Distribuição Global: A infraestrutura da Didit é globalmente distribuída, garantindo baixa latência para usuários, independentemente de sua localização geográfica. Isso significa que as chamadas de API para os endpoints de verificação da Didit são roteadas para o data center mais próximo, minimizando o tempo de viagem da rede.
• Otimizado para Tempo Real: Produtos como Vivacidade Passiva e Ativa e 1:1 Face Match são projetados para processamento em tempo real, aproveitando modelos avançados de IA que são executados de forma rápida e eficiente.
• Escalabilidade: A arquitetura modular da Didit é construída para escala, capaz de lidar com grandes volumes de requisições de verificação sem degradação no desempenho, mesmo durante períodos de pico. Isso é crucial para aplicações que exigem alto throughput para serviços como Verificação de Telefone e E-mail ou Comprovação de Endereço.
• APIs Focadas no Desenvolvedor: APIs limpas e bem documentadas garantem que os desenvolvedores possam integrar de forma eficiente, reduzindo o tempo de desenvolvimento e o potencial de gargalos de desempenho relacionados à integração. O processo de registro programático, que exige apenas duas chamadas de API, exemplifica essa abordagem focada no desenvolvedor.

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

Como a Didit Ajuda

A Didit foi projetada para fornecer uma experiência de verificação de identidade confiável e de alto desempenho. Nossa plataforma nativa de IA oferece uma arquitetura modular, permitindo que você integre primitivas de identidade específicas como Verificação de ID (com suporte a OCR, MRZ e código de barras), Vivacidade Passiva e Ativa, 1:1 Face Match e AML Screening & Monitoring conforme necessário. Essa modularidade significa que você usa apenas os recursos que precisa, otimizando tanto o custo quanto o desempenho. A oferta de KYC Core Gratuito da Didit, sem taxas de configuração e um modelo de pagamento por verificação bem-sucedida, torna incrivelmente acessível começar. Nossa infraestrutura globalmente distribuída garante que suas chamadas de API se beneficiem de baixa latência e alta disponibilidade, tornando a necessidade de cache CDN tradicional de respostas de API menos relevante, pois a natureza dinâmica da verificação de identidade exige processamento em tempo real. Capacitamos os desenvolvedores com uma solução robusta e escalável que prioriza inerentemente a velocidade e a eficiência, permitindo que você se concentre na construção de ótimas aplicações enquanto nós lidamos com as complexidades da confiança de 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.