Depuració d'Integracions Didit: Errors Comuns i Estratègies (CA)

Problemes d'Autenticació i Clau APIAssegureu-vos que les vostres claus API estiguin correctament configurades i les variables d'entorn ben establertes, ja que les fallades d'autenticació són un obstacle inicial comú per a qualsevol integració API.

Límit de Peticions i ThrottlingImplementeu una gestió robusta del límit de peticions amb retrocés exponencial i monitoritzeu les capçaleres X-RateLimit per prevenir interrupcions del servei i garantir l'estabilitat de l'aplicació.

Gestió del Cicle de Vida de la SessióCompreneu el cicle de vida complet de les sessions de verificació de Didit, des de la creació i les actualitzacions d'estat fins a la recuperació de decisions, per seguir amb precisió el progrés de la verificació de l'usuari.

Enfocament de Didit Centrat en el DesenvolupadorDidit proporciona documentació completa, sandboxes instantànies i APIs netes, simplificant significativament el procés de depuració i reduint les complexitats de la integració per als desenvolupadors.

Integrar la verificació d'identitat en la vostra aplicació és un pas crític per a la seguretat i el compliment normatiu. No obstant això, com qualsevol sistema complex, la integració amb una plataforma d'identitat com Didit pot presentar reptes de depuració únics. Aquesta guia està dissenyada per ajudar els desenvolupadors a identificar i resoldre problemes comuns, garantint un procés d'integració fluid i eficient amb els potents serveis de verificació d'identitat de Didit.

Comprensió de l'Autenticació i Configuració de l'API

Un dels punts de partida més freqüents per als problemes d'integració rau en l'autenticació i configuració de l'API. Les claus API mal configurades, les variables d'entorn incorrectes o les restriccions d'accés a la xarxa poden provocar errors d'autenticació frustrants.

Errors Comuns:

• Clau API Incorrecta: Assegureu-vos que la clau API utilitzada en les vostres peticions coincideixi amb la proporcionada a la vostra Consola de Negocis de Didit. Recordeu que les claus API distingeixen entre majúscules i minúscules.
• Problemes amb Variables d'Entorn: Si esteu emmagatzemant la vostra clau API en una variable d'entorn (per exemple, DIDIT_API_KEY), comproveu que es carregui i sigui accessible correctament per la vostra aplicació en temps d'execució.
• Permisos: Verifiqueu que la clau API tingui els permisos necessaris per a les operacions que intenteu realitzar. Algunes operacions podrien requerir àmbits específics.
• Restriccions de Xarxa: Els tallafocs o servidors intermediaris de vegades poden bloquejar les trucades API sortints. Assegureu-vos que el vostre servidor tingui accés sense restriccions als punts finals de l'API de Didit.

Estratègies de Resolució de Problemes:

• Recomproveu les Credencials: La solució més senzilla sol ser la més efectiva. Copieu i enganxeu la vostra clau API directament des de la Consola de Negocis de Didit per evitar errors tipogràfics.
• Utilitzeu una Eina com cURL o Postman: Abans d'integrar-la al vostre codi base, proveu la vostra clau API amb una comanda cURL directa o una petició Postman per aïllar els problemes d'autenticació dels errors a nivell d'aplicació.
• Examineu els Missatges d'Error: L'API de Didit proporciona missatges d'error clars. Una resposta 401 Unauthorized o 403 Forbidden sol indicar problemes d'autenticació o de permisos.
• Consulteu la Documentació de Didit: La Referència de l'API de Didit proporciona informació detallada sobre els mètodes d'autenticació i les capçaleres esperades.

Gestió de Límits de Peticions i Throttling de l'API

Per mantenir l'estabilitat i l'ús just, Didit, com la majoria de proveïdors d'API robustos, implementa límits de peticions. No tenir en compte aquests límits pot provocar interrupcions temporals del servei i errors 429 Too Many Requests.

Errors Comuns:

• Peticions en Ràfega: Enviar un gran nombre de peticions en un curt període, especialment per a operacions que consumeixen molts recursos com la creació de sessions o la recuperació de decisions, pot superar ràpidament els límits. Per exemple, POST /v2/session/ té un límit de 600 peticions per minut, mentre que GET /v2/session/<id>/decision/ està limitat a 100 peticions per minut per evitar un sondeig excessiu.
• Ignorar les Capçaleres de Límit de Peticions: No monitoritzar les capçaleres X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset pot provocar un throttling inesperat.
• Manca de Retrocés Exponencial: Sense una estratègia de retrocés exponencial, reintentar immediatament després d'un error 429 probablement resultarà en fallades continuades.

Estratègies de Resolució de Problemes:

• Monitoritzeu les Capçaleres: Analitzeu i responeu sempre a les capçaleres de límit de peticions proporcionades a les respostes de l'API de Didit. Això permet que la vostra aplicació s'auto-reguli proactivament.
• Implementeu el Retrocés Exponencial: Quan rebeu una resposta 429, espereu un temps cada vegada més llarg abans de reintentar la petició. Un patró comú és 5s → 10s → 20s → 40s.
• Operacions per Lots: Sempre que sigui possible, feu operacions per lots o dissenyeu el vostre flux de treball per reduir la freqüència de les trucades a l'API.
• Límit de Peticions Distribuït: Si teniu diverses instàncies d'aplicació, considereu un mecanisme centralitzat de límit de peticions per evitar superar els límits globals des d'instàncies separades.

Gestió del Cicle de Vida de les Sessions de Verificació

El procés de verificació d'identitat de Didit gira al voltant de les sessions. Comprendre com crear, gestionar i recuperar resultats d'aquestes sessions és fonamental. Els problemes sovint sorgeixen de la incomprensió dels estats de la sessió o de la gestió inadequada dels fluxos de verificació asíncrons.

Errors Comuns:

• Creació de Sessió Incorrecta: No proporcionar tots els paràmetres requerits en trucar a didit_create_session o utilitzar una ID de flux de treball no vàlida pot impedir que una sessió s'iniciï correctament.
• Sondeig Massa Freqüent: Trucar repetidament a didit_get_session_decision sense retards adequats pot superar els límits de peticions i malgastar recursos.
• No Gestionar Tots els Resultats de la Sessió: Una sessió pot tenir diversos estats (per exemple, pending, approved, declined, resubmission_requested), i la vostra aplicació ha d'estar preparada per gestionar cadascun d'ells.
• Configuració Incorrecta del Webhook: Dependre únicament del sondeig en lloc dels webhooks per a les actualitzacions de la sessió pot introduir latència i complexitat. Si utilitzeu webhooks, assegureu-vos que estiguin correctament configurats i que el vostre punt final sigui accessible i responsiu.

Estratègies de Resolució de Problemes:

• Reviseu la Configuració del Flux de Treball: Utilitzeu didit_get_workflow per inspeccionar la configuració dels vostres fluxos de treball de verificació, assegurant-vos que s'alineen amb els vostres passos de verificació esperats (per exemple, Verificació d'ID, Liveness Passiu i Actiu, Coincidència Facial 1:1).
• Utilitzeu els Webhooks de Didit: Configureu webhooks per rebre actualitzacions en temps real sobre els canvis d'estat de la sessió. Aquesta és la manera més eficient de gestionar els resultats de verificació asíncrons. Valideu la signatura del vostre webhook per garantir l'autenticitat de les peticions entrants.
• Registreu les ID de Sessió: Registreu sempre la session_id de Didit quan es crea una sessió. Aquesta ID és crucial per a la depuració i la recuperació d'informació detallada posteriorment utilitzant eines com didit_get_session_decision.
• Proveu Casos Extrems: Simuleu diversos resultats, incloses verificacions exitoses, rebuigs i casos que requereixen una nova presentació, per assegurar-vos que la vostra aplicació gestiona totes les possibilitats amb gràcia.

Com Ajuda Didit

Didit està dissenyat pensant en els desenvolupadors, oferint un conjunt de característiques que simplifiquen significativament la integració i la depuració. La nostra plataforma d'identitat modular i nativa d'IA proporciona eines robustes per prevenir i resoldre problemes comuns d'integració.

• Disseny Centrat en el Desenvolupador: Didit ofereix un sandbox instantani, documentació pública completa i APIs netes, facilitant l'inici i la resolució de problemes. El nostre enfocament API-first significa que podeu gestionar tots els aspectes de la verificació d'identitat de manera programàtica.
• Arquitectura Modular: Les nostres primitives d'identitat composables, incloent Verificació d'ID (OCR, MRZ, codis de barres), Liveness Passiu i Actiu, Coincidència Facial 1:1 i Anàlisi AML, us permeten construir i provar fluxos de verificació de manera incremental, aïllant possibles problemes a mòduls específics.
• Fluxos de Treball Orquestrats: La Consola de Negocis sense codi us permet configurar i provar fluxos de treball KYC complexos visualment, reduint la probabilitat d'errors lògics en la vostra integració.
• Integració d'Agents d'IA (Servidor MCP): Didit està construït per a l'era agent. El nostre servidor de Protocol de Context de Model (MCP) permet que els agents de codificació d'IA interactuïn directament amb la plataforma, automatitzant tasques com el registre de comptes, la configuració de fluxos de treball i la gestió de sessions, reduint encara més els errors manuals i accelerant la depuració.
• KYC Bàsic Gratuït: Comenceu a verificar identitats sense costos inicials, permetent proves i depuració extenses en un entorn similar a la producció sense barreres financeres. El nostre model de pagament per verificació exitosa, sense despeses de configuració, garanteix que només pagueu pel que utilitzeu.
• Informes d'Errors Detallats: Les APIs de Didit proporcionen missatges d'error clars i accionables, guiant-vos directament a la causa principal del problema.

Preparat per Començar?

Voleu veure Didit en acció? Obteniu una demostració gratuïta avui mateix.

Comenceu a verificar identitats de forma gratuïta amb la capa gratuïta de Didit.