Guía del Desarrollador: Optimización de Llamadas a la API de Didit para Caché en el Borde de CDN (ES)

Comprender los Límites de TasaDidit aplica límites de tasa globales y específicos por endpoint para mantener la estabilidad de la API, proporcionando encabezados como X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para el control de flujo del lado del cliente.

Implementar Retirada ExponencialPara respuestas 429, integre una estrategia de retirada exponencial (ej., 5s → 10s → 20s) para manejar con elegancia las sobrecargas temporales de la API y prevenir violaciones de límites de tasa del lado del cliente.

Aprovechar CDN para Activos EstáticosAunque la API central de Didit no puede ser almacenada en caché por CDNs tradicionales, optimice los activos estáticos de su aplicación (JS, CSS, imágenes) a través de CDN para reducir los tiempos de carga y mejorar el rendimiento percibido.

Arquitectura de Rendimiento de DiditLa infraestructura nativa de IA y distribuida globalmente de Didit ofrece inherentemente baja latencia y alta disponibilidad, convirtiéndola en una opción ideal para necesidades de verificación de identidad críticas para el rendimiento.

En el vertiginoso panorama digital actual, cada milisegundo cuenta. Para los desarrolladores que integran servicios de verificación de identidad, optimizar las llamadas a la API para lograr velocidad y eficiencia es primordial. Si bien las Redes de Entrega de Contenido (CDN) a menudo se asocian con el almacenamiento en caché de activos estáticos, comprender cómo interactuar mejor con los servicios de API, especialmente aquellos diseñados para operaciones dinámicas y en tiempo real como la verificación de identidad, es crucial para el rendimiento general de la aplicación. Esta guía profundiza en la optimización de sus integraciones con la API de Didit, centrándose en la limitación de tasas, patrones de llamadas eficientes y cómo la arquitectura de Didit soporta inherentemente un alto rendimiento.

Comprendiendo los Límites de Tasa de la API de Didit

Didit, como cualquier servicio de API robusto, implementa límites de tasa para garantizar la estabilidad y el uso justo entre todos los clientes. Estos límites son críticos para prevenir el abuso y mantener un rendimiento consistente. Comprenderlos y adherirse a ellos es el primer paso hacia interacciones optimizadas con la API.

Didit aplica múltiples capas de limitación de tasas:

• Límites Globales: Para los endpoints GET generales, hay un límite de 300 solicitudes por minuto por aplicación. De manera similar, los endpoints POST, PATCH y DELETE (escritura/eliminación) también tienen un límite global de 300 solicitudes por minuto por aplicación.
• Límites Específicos por Endpoint: Ciertas operaciones de alto impacto tienen límites más restrictivos. Por ejemplo, POST /v2/session/ (para crear sesiones de verificación, a menudo involucrando los productos de verificación de identidad o estimación de edad de Didit) está limitado a 600 solicitudes por minuto. La recuperación de decisiones de sesión (`GET /v2/session//decision/) está limitada a 100 solicitudes por minuto para evitar un sondeo excesivo, y la generación de PDF (GET /session//generate-pdf/`) también está limitada a 100 solicitudes por minuto debido a su naturaleza intensiva en CPU.

Cuando se excede un límite de tasa, la API de Didit responde con un código de estado 429 Too Many Requests. Fundamentalmente, estas respuestas incluyen encabezados útiles:

• X-RateLimit-Limit: El número máximo de solicitudes permitidas.
• X-RateLimit-Remaining: El número de solicitudes restantes en la ventana actual.
• X-RateLimit-Reset: La hora (en segundos epoch) en que se restablece la ventana actual del límite de tasa.

Al monitorear estos encabezados, su aplicación puede auto-regularse proactivamente, previniendo errores 429 innecesarios y asegurando un flujo operativo más fluido para servicios como el cribado AML o la detección de vivacidad de Didit.

Implementación de Throttling y Retirada Inteligentes del Lado del Cliente

El manejo efectivo de los límites de tasa por parte del cliente es vital para una integración resiliente. Aquí le explicamos cómo hacerlo:

1. Observar los Encabezados de Límite de Tasa: Implemente lógica para leer el encabezado X-RateLimit-Remaining. Cuando este valor caiga por debajo de un cierto umbral (por ejemplo, 15% de X-RateLimit-Limit), su cliente debe comenzar a reducir su tasa de solicitudes.

2. Retirada Exponencial para 429s: Esta es una estrategia crítica. Si su aplicación recibe una respuesta 429, debe pausar antes de reintentar la solicitud. En lugar de reintentos inmediatos, implemente un algoritmo de retirada exponencial. Por ejemplo, espere 5 segundos, luego 10 segundos, luego 20 segundos, y así sucesivamente. Esto evita sobrecargar aún más la API y permite que la ventana del límite de tasa se restablezca. El encabezado Retry-After de Didit también puede informar su estrategia de retirada.

3. Registrar y Alertar: Mantenga un registro de cuándo se alcanzan los límites de tasa y cuándo se activan los reintentos. Esto proporciona información valiosa sobre los patrones de uso de su aplicación y puede ayudar a identificar áreas de optimización o indicar la necesidad de solicitar un límite más alto al soporte de Didit para casos de uso específicos.

El Papel del Caché en el Borde de CDN en el Rendimiento de la API

Si bien las APIs centrales de verificación de identidad de Didit, como las de Verificación de ID, Coincidencia Facial 1:1 o Verificación NFC, implican un procesamiento dinámico y en tiempo real que no puede ser efectivamente almacenado en caché por una CDN (ya que cada solicitud es única y requiere un cálculo nuevo), las CDN aún juegan un papel en el rendimiento general de su aplicación.

Las CDN destacan en el almacenamiento en caché de contenido estático (imágenes, archivos JavaScript, CSS, videos) en ubicaciones de borde más cercanas a sus usuarios. Al servir estos activos desde una CDN, usted reduce la carga en su servidor de origen y disminuye la latencia para sus usuarios. Esto mejora el rendimiento percibido de su aplicación, haciendo que la experiencia general, incluido el flujo de verificación de identidad, se sienta mucho más rápida y receptiva.

Por ejemplo, si su aplicación utiliza un flujo de trabajo de Didit que implica una interfaz de usuario basada en web (por ejemplo, para la recopilación de cargas de documentos o selfies de detección de vivacidad), los activos estáticos para esa UI pueden ser servidos a través de una CDN. Si bien las llamadas a la API al backend de Didit para procesar la verificación son directas, la velocidad del entorno de la aplicación circundante impacta significativamente la satisfacción del usuario.

Arquitectura Nativa de IA de Didit para un Rendimiento Inigualable

Didit está construido desde cero como una plataforma de identidad nativa de IA y orientada al desarrollador. Esta elección arquitectónica proporciona inherentemente ventajas significativas de rendimiento que complementan sus estrategias de CDN para activos estáticos:

• Distribución Global: La infraestructura de Didit está distribuida globalmente, garantizando baja latencia para los usuarios independientemente de su ubicación geográfica. Esto significa que las llamadas a la API a los endpoints de verificación de Didit se enrutan al centro de datos más cercano, minimizando el tiempo de viaje de la red.
• Optimizado para Tiempo Real: Productos como Detección de Vivacidad Pasiva y Activa, y Coincidencia Facial 1:1 están diseñados para procesamiento en tiempo real, aprovechando modelos avanzados de IA que se ejecutan de forma rápida y eficiente.
• Escalabilidad: La arquitectura modular de Didit está diseñada para escalar, capaz de manejar grandes volúmenes de solicitudes de verificación sin degradación del rendimiento, incluso durante los períodos pico. Esto es crucial para aplicaciones que requieren un alto rendimiento para servicios como Verificación de Teléfono y Correo Electrónico o Prueba de Domicilio.
• APIs Primero para Desarrolladores: APIs limpias y bien documentadas aseguran que los desarrolladores puedan integrarse de manera eficiente, reduciendo el tiempo de desarrollo y el potencial de cuellos de botella de rendimiento relacionados con la integración. El proceso de registro programático, que requiere solo dos llamadas a la API, ejemplifica este enfoque orientado al desarrollador.

Al centrarse en prácticas eficientes de consumo de API, como el manejo inteligente de límites de tasa y la retirada exponencial, puede aprovechar al máximo el backend de alto rendimiento y nativo de IA de Didit para ofrecer una experiencia de verificación de identidad fluida y rápida.

Cómo Ayuda Didit

Didit está diseñado para proporcionar una experiencia de verificación de identidad de alto rendimiento y confiable. Nuestra plataforma nativa de IA ofrece una arquitectura modular, lo que le permite integrar primitivas de identidad específicas como la Verificación de ID (con soporte OCR, MRZ y código de barras), Detección de Vivacidad Pasiva y Activa, Coincidencia Facial 1:1 y Cribado y Monitoreo AML según sea necesario. Esta modularidad significa que solo utiliza los recursos que necesita, optimizando tanto el costo como el rendimiento. La oferta de KYC Core Gratuito de Didit, sin tarifas de configuración y un modelo de pago por verificación exitosa, lo hace increíblemente accesible para comenzar. Nuestra infraestructura distribuida globalmente garantiza que sus llamadas a la API se beneficien de baja latencia y alta disponibilidad, haciendo que la necesidad de un almacenamiento en caché CDN tradicional de las respuestas de la API sea menos relevante, ya que la naturaleza dinámica de la verificación de identidad exige procesamiento en tiempo real. Capacitamos a los desarrolladores con una solución robusta y escalable que inherentemente prioriza la velocidad y la eficiencia, permitiéndole concentrarse en construir grandes aplicaciones mientras nosotros nos encargamos de las complejidades de la confianza de identidad.

¿Listo para Empezar?

¿Listo para ver Didit en acción? Obtenga una demostración gratuita hoy mismo.

Comience a verificar identidades de forma gratuita con el nivel gratuito de Didit.