Saltar al contingut principal
Transcripció completa de Integra Didit a la teva app: API, SDK i webhooks (guia per a desenvolupadors) - Vídeo 8 de 10 de Didit Academy, 08:13. Mira-ho a YouTube. Cada paràgraf enllaça al moment exacte del vídeo.

​
El que connectaràs

00:04 En aquest vídeo, connectaràs Didit a la teva pròpia app. Així, els teus usuaris es verifiquen directament dins del teu producte, i cada resultat arriba al teu sistema en el mateix moment en què es produeix. Aquest és el vídeo per a desenvolupadors, així que és una mica més tècnic, però és més senzill del que sembla. I al final veuràs que pots lliurar gairebé tot a Cloud Code i que ho construeixi per tu. Així que ho repassarem en l’ordre

​
SDK, API i webhook: les tres peces

00:28 en què ho construiries de debò. Comencem. Integrar Didit implica connectar tres coses. El SDK mostra a la teva app la càmera, la captura del document, la lectura NFC i la interfície de prova de vida. L’API és de servidor a servidor, així que el teu backend crea la sessió i llegeix la decisió definitiva. I el webhook crida el teu endpoint HTTPS en el moment exacte en què una sessió canvia d’estat, i això és molt més ràpid i complet que fer consultes periòdiques.

​
La pestanya Integrate

00:56 Així que la manera més fàcil d’integrar és anar a la pestanya Manage, fer clic a Integrate i agafar aquí tota la configuració. Així podem obtenir la nostra clau d’API. Per tant, podríem configurar una clau d’API específica per a aquesta app en què estem treballant. Podem crear i triar un flux de treball que vulguem integrar. Podem afegir un webhook. Aquí és on s’envien els resultats de la verificació. 01:24 I el secret de signatura, que et mostraré d’aquí a un moment, és el que ha d’anar

​
Triar la plataforma

01:28 al teu fitxer ENV. Després pots connectar-lo a la teva app. Tenim diverses opcions aquí: web JS, React Native, iOS, Android, Flutter i algunes altres plataformes aquí. Així que pots seleccionar la que sigui rellevant per a la teva app. Aquests són els secrets d’entorn que has de posar al teu fitxer ENV del teu

​
El prompt de configuració amb IA

01:48 servidor. Així que la manera fàcil de configurar-ho és usar el prompt de configuració amb IA. Configurem totes les opcions aquí dalt, després copiem el prompt i copiarà tota la informació rellevant que necessitem de la configuració que has completat aquí. Ho copies i ho enganxes, i ho pots posar a Cloud Code o Codex o on sigui que estiguis construint la teva app.

​
Claus d’API, una per entorn

02:09 Les teves claus d’API són aquí, i cada fila té una clau, d’acord? Per això, un bon hàbit és tenir una clau separada per entorn i per integració. Així pots rotar-ne o revocar-ne una sense trencar les altres. Així que si vols integrar un flux de treball concret, potser

​
Crear una clau

02:27 voldràs tenir una clau d’API separada només per a aquest flux de treball, per exemple. Ara, si faig clic a crear clau d’API, eh, només posaré test aquí, i crearé la clau d’API. Ara puc copiar-la, oi? I no la tornaré a veure. Per tant és important que la copiïs i potser l’anotis en algun lloc perquè la puguis fer servir quan facis la integració. Quan arribes a la secció d’integració i agafes la teva clau d’API, i suposem que agafo la clau test i baixo, selecciono, d’acord, volem fer servir aquest, eh, flux de treball KYC. Podem afegir un webhook. 03:05 Podem connectar la nostra app, d’acord. I després podem enganxar aquí el prompt de configuració. Pots veure aquí que aquest prompt va a

​
Visió general dels webhooks

03:13 incloure la clau d’API. Així que, passant als webhooks, ràpidament: podem configurar un webhook per a gairebé qualsevol cosa que vulguem. Per exemple, si vols enviar un esdeveniment concret a Slack, d’acord? Podem

​
La documentació

03:25 afegir la URL del webhook aquí. D’acord, fem una ullada a una part de la documentació, perquè tens accés a tota la documentació tècnica. Només cal anar a docs.didit.me, i mirarem algunes coses

​
Crear sessió: l’únic camp obligatori

03:37 aquí dins. Tot gira al voltant de la creació de la sessió. Bé, això és una petició POST. És l’inici d’una verificació. Podem veure aquí, a la petició curl, que tenim l’ID del flux de treball. Aquest és l’únic camp obligatori, i la part realment útil és que el mateix endpoint crea sessions de KYC i de KYB. El

​
Dades del proveïdor i URL de callback

04:00 flux de treball és el que decideix quina és quina. Hi ha alguns camps addicionals aquí a sota, incloent-hi les dades del proveïdor, de les quals hem parlat molt en aquests vídeos. És l’identificador únic de cada usuari, i pots definir-lo com vulguis: pot ser un correu electrònic o un identificador únic. I després tenim aquí la URL de callback. És on s’envia l’usuari després de completar el flux de verificació. Així que,

​
Provar l’endpoint en directe

04:24 si baixem aquí, ho podem provar. Si fem clic a Prova-ho, podem crear una sessió de verificació aquí mateix. Així que només posaré una de les claus d’API aquí. Ara en crearé una de nova, test two. La copiaré. La enganxo aquí. Volem agafar un ID de flux de treball. Així que anem aquí. Podem agafar aquest ID de flux de treball aquí. El introduïm allà. Les dades del proveïdor no són obligatòries. Posem-hi una cadena de números aleatòria. 05:02 El callback, el podem deixar igual aquí. Cap d’això és obligatori, per cert. Crec que és perquè tinc un compte de prova aquí, però si volguessis provar aquest endpoint, això és exactament com ho provaries. Ara bé, si ets desenvolupador i vols respostes concretes, pots consultar la documentació. El MCP també té accés a tota aquesta documentació, així que pots integrar el MCP i preguntar a Claude qualsevol dubte tècnic que probablement aparegui en aquests documents.

​
Webhooks: per què no fer sondeig

05:32 dins d’aquest espai. Parlem, doncs, dels webhooks. Aquí, a la secció de gestió, hi ha una pestanya per als webhooks, i és així com els resultats t’arriben de veritat. Els webhooks són el canal recomanat perquè el sondeig és bastant lent i

​
Afegir una destinació i triar esdeveniments

05:44 et costarà més peticions i se’t saltaran esdeveniments. Així que afegim una nova destinació del webhook aquí. Podem enganxar una URL. Podem triar els esdeveniments que volem. Són, doncs, totes les dades que volem enviar a aquest endpoint concret. I Didit et retornarà un secret de signatura d’un sol ús, que et mostraré d’aquí a un moment. A més, la URL ha de ser directament accessible. Així que no hi pot haver localhost ni IP privades. Ara surto d’aquí i podem desplaçar-nos cap a la dreta, on tenim algunes opcions. 06:16 Aquí podem veure el nombre d’esdeveniments que escolta aquest webhook i podem

​
El secret de signatura

06:19 copiar el secret de signatura, que serà important per a la teva integració. Ara bé, quan fem la configuració de la integració a la pestanya d’integracions, i ja t’hi he guiat, hi ha un prompt. Aleshores el secret de signatura hi serà, per al webhook que hagis seleccionat a la configuració. Així que

​
La indicació per al gestor de webhooks

06:34 una altra de les maneres d’aprofitar la IA: tenim un prompt preparat que vaig trobar a la pestanya de webhooks. Podem veure si vols configurar el gestor de webhooks amb IA. Podem consultar la documentació i trobar-hi un prompt d’integració. Aquest prompt cobrirà la verificació d’identitat, les entitats i les transaccions. Ho construirà tot per a tu. Ho deixa tot ben explicat: què cal construir, les capçaleres de signatura de la verificació, els tipus d’esdeveniments de webhook que acabes de veure quan configuràvem un webhook, l’embolcall del webhook i molt més. A més, també podem triar on ho volem enganxar, en quina eina la fem servir. 07:15 Així que, si vols fer servir aquest prompt, aquesta és la manera més fàcil de començar i tenir les integracions a punt. Tot el que acabo de repassar en aquest vídeo és accessible i consultable dins de la teva eina d’IA si integres el servidor MCP. Així que pots explicar en anglès planer el que vols que passi, i Cloud Code llegirà la documentació i construirà la integració per a tu. Només cal que revisis el resultat i comprovis que s’executa i funciona, en lloc de programar-ho tot des de zero.

​
Resum

07:41 Això és Didit a la teva aplicació: el SDK que veuen els teus usuaris, l’API que crida el teu sistema de backend i el webhook signat que lliura el veredicte sobre el qual construeixes. Confia en el webhook, fes servir les dades del proveïdor a tot arreu i aprofita el prompt de configuració, perquè no programis a mà les parts més tediosses. Pots anar a didit.me, registrar-te gratuïtament i fer una verificació en qüestió de minuts.
Darrera modificació el 7 de novembre del 2026