Integrazione Didit: API, SDK e webhook

Trascrizione completa di Integra Didit nella tua app: API, SDK e webhook (guida per sviluppatori) - Didit Academy, video 8 di 10, 08:13. Guarda su YouTube. Ogni paragrafo rimanda al momento esatto del video.

​

Cosa collegherai

00:04 In questo video integrerai Dedit nella tua app. Così i tuoi utenti si verificano direttamente all’interno del tuo prodotto, e ogni risultato torna al tuo sistema nel momento esatto in cui avviene. Questo è il video per sviluppatori, quindi è un po’ più tecnico, ma è più semplice di quanto pensi. Alla fine vedrai che puoi affidarne gran parte direttamente a Cloud Code e farla costruire per te. Quindi lo vedremo nell’ordine in cui

​

SDK, API e webhook: i tre elementi

00:28 lo costruiresti davvero. Andiamo subito al punto. Integrare Dedit significa collegare tre elementi. L’SDK visualizza la fotocamera, l’acquisizione del documento, la lettura NFC e l’interfaccia del rilevamento della vitalità direttamente all’interno della tua app. L’API è di tipo server-to-server, quindi il tuo backend crea la sessione e legge la decisione ufficiale. E il webhook chiama il tuo endpoint HTTPS nell’istante in cui una sessione cambia stato, il che è molto

​

La scheda Integra

00:56 più veloce e ricco di informazioni rispetto al polling. Quindi il modo più semplice per integrare è andare nella scheda Gestisci, cliccare su Integra, e possiamo prendere tutte le impostazioni da qui, quindi possiamo prendere la nostra chiave API. Potremmo configurare una chiave API specifica per questa particolare app su cui stiamo lavorando. Possiamo creare e scegliere un workflow che vogliamo integrare. Possiamo aggiungere un webhook. Ecco dove vengono inviati i risultati della verifica. 01:24 E il segreto di firma, che ti mostrerò tra un attimo, è ciò che andrà

​

Scegliere la piattaforma

01:28 nel tuo file ENV. Poi puoi collegarlo alla tua app. Qui ci sono diverse opzioni: Web JS, React Native, iOS, Android, Flutter e alcune altre piattaforme. Quindi puoi selezionare quella pertinente per la tua app. Questi sono i segreti dell’ambiente che inserirai nel tuo file ENV, sul tuo

​

Il prompt di configurazione con IA

01:48 server. Il modo più semplice per configurarlo è usare il prompt di configurazione con IA. Quindi configuriamo tutte le impostazioni qui sopra, poi copiamo il prompt e questo copierà tutte le informazioni pertinenti che ci servono dalla configurazione che abbiamo completato qui. Copiamo e incolliamo il tutto, e possiamo inserirlo in Cloud Code, Codex o dovunque tu stia

​

Chiavi API, una per ambiente

02:09 costruendo la tua app. Le tue chiavi API si trovano qui, e ogni riga contiene una chiave, ok? Quindi una buona abitudine è avere una chiave separata per ogni ambiente e per ogni integrazione. Così puoi ruotare o revocare una chiave senza interrompere le altre. Quindi, se stai per integrare un workflow specifico, tu

​

Creare una chiave

02:27 potresti voler avere una chiave API separata solo per quel workflow, per esempio. Ora, se clicco su crea una chiave API, ehm, scrivo semplicemente test qui, e creo la chiave API. Adesso posso copiarla, giusto? E non la vedrò più. Quindi è importante che tu la copi e magari la annoti da qualche parte, così potrai usarla quando farai l’integrazione. Quando arrivi alla sezione dell’integrazione e prendi la tua chiave API, e diciamo che prendo la chiave test e scorro in basso, seleziono, ok, vogliamo usare questo, ehm, vediamo, workflow KYC. Possiamo aggiungere un webhook. 03:05 Possiamo collegare la nostra app, ok. E poi inseriamo qui questo prompt di configurazione. Qui vedi che questo prompt includerà

​

Panoramica dei webhook

03:13 la chiave API. Passando rapidamente ai webhook, possiamo configurarne uno per praticamente qualunque cosa vogliamo. Per esempio, se vuoi inviare un evento specifico a Slack, giusto? Possiamo

​

La documentazione

03:25 aggiungere qui l’URL del webhook. Ok, diamo un’occhiata alla documentazione, perché hai accesso a tutta la documentazione tecnica. Basta andare su docs.didit.me, e vediamo alcune cose

​

Creare una sessione: l’unico campo obbligatorio

03:37 qui. Tutto ruota attorno alla creazione della sessione. Ok, questa è una richiesta POST. È l’inizio di una verifica. Qui nella richiesta curl vediamo che abbiamo l’ID del workflow. È l’unico campo obbligatorio, e la parte davvero utile è che questo stesso endpoint crea sia sessioni KYC sia sessioni KYB. Il

​

Dati del fornitore e URL di callback

04:00 workflow è ciò che decide di quale si tratta. Ci sono alcuni campi aggiuntivi più in basso, incluso i dati del fornitore, di cui abbiamo parlato molto in questi video. È l’identificativo univoco di ogni utente, e puoi definirlo come preferisci, che sia un’email o un identificativo univoco, e poi qui c’è l’URL di callback. È qui che l’utente viene reindirizzato dopo aver completato il workflow di verifica. Quindi,

​

Provare l’endpoint dal vivo

04:24 se scorriamo in basso qui, possiamo provarlo davvero. Quindi, se clicchiamo prova, possiamo creare qui una sessione di verifica. Inserisco una delle chiavi API qui. Ne creo una nuova, test two. La copio. La inserisco qui. Ci serve un ID del workflow. Quindi andiamo qui. Possiamo prendere questo ID del workflow. Lo inseriamo lì. I dati del fornitore non sono obbligatori. Mettiamo semplicemente una stringa casuale di numeri. 05:02 L’URL di callback la lasciamo com’è qui. Comunque, nulla di tutto questo è obbligatorio. Penso dipenda dal fatto che ho un account di test, ma se volessi testare questo endpoint, è esattamente così che lo faresti. Ora, se sei uno sviluppatore e vuoi risposte specifiche, puoi consultare la documentazione. Anche l’MCP ha accesso a tutta questa documentazione, quindi puoi semplicemente integrare l’MCP e porre una domanda a Claude su qualcosa di tecnico che probabilmente si trova in questi documenti

​

Webhook: perché non usare il polling

05:32 all’interno di questa sezione. Parliamo quindi dei webhook. Nella sezione Manage c’è una scheda dedicata ai webhook, ed è così che i risultati ti arrivano davvero. I webhook sono il canale consigliato perché il polling è piuttosto lento e finisce per

​

Aggiungere una destinazione e scegliere gli eventi

05:44 costarti più richieste e per saltare eventi. Quindi aggiungiamo una nuova destinazione qui. Possiamo incollare un URL e scegliere gli eventi che vogliamo. Questi sono tutti i dati che vogliamo inviare a questo specifico endpoint. Didit ti restituirà un segreto di firma monouso, che ti mostrerò tra poco. L’URL deve essere raggiungibile direttamente, quindi niente localhost e niente IP privati. Ora esco da qui e scorriamo verso destra, dove abbiamo alcune opzioni. 06:16 Qui vediamo il numero di eventi per i quali questo webhook è in ascolto, e possiamo

​

Il segreto di firma

06:19 copiare il segreto di firma, che sarà importante per la tua integrazione. Quando facciamo la configurazione dell’integrazione nella scheda Integrations, di cui ti ho parlato, c’è un prompt, e il segreto di firma si trova qui, per il webhook che hai selezionato nella configurazione. Quindi

​

Il prompt per il gestore dei webhook

06:34 un altro modo per sfruttare l’AI: abbiamo un prompt già pronto che ho trovato nella scheda dei webhook. Possiamo vedere se vuoi configurare il tuo gestore dei webhook con l’AI. Possiamo consultare la documentazione e trovare qui un prompt di integrazione. Copre la verifica dell’identità, delle entità e delle transazioni. Costruisce tutto per te. Definisce tutto: cosa realizzare, le intestazioni di firma per la verifica, i tipi di evento webhook che abbiamo appena visto quando configuravamo un webhook, la busta del webhook e molto altro. Possiamo anche scegliere in quale strumento incollarlo, tra quelli che usiamo. 07:15 Quindi, se vuoi usare questo prompt, è il modo più semplice per iniziare e avere le integrazioni pronte. Tutto ciò che ho appena illustrato in questo video è accessibile e interrogabile dal tuo strumento AI se integri il server MCP. Puoi quindi spiegare in inglese semplice cosa vuoi che accada, e Cloud Code leggerà la documentazione e costruirà l’integrazione per te. Ti resta solo da verificare il lavoro, assicurandoti che sia in esecuzione e funzioni

​

Riepilogo

07:41 invece di scrivere tutto da zero. Ecco quindi Didit nella tua app: l’SDK che vedono i tuoi utenti, l’API che il tuo back end chiama e il webhook firmato che consegna il verdetto su cui costruisci. Affidati al webhook, usa i dati del fornitore ovunque e sfrutta il prompt di configurazione, così non dovrai cablare a mano le parti noiose. Puoi andare su didit.me, registrarti gratis e eseguire una verifica in pochi minuti.