Vai al contenuto principale
Il gem ufficiale Didit per Ruby. Richiede Ruby 3.1 o successivo e usa net/http dalla libreria standard. Consulta la panoramica degli SDK server per ciò che tutti gli SDK hanno in comune.

Installazione

Il gem è didit-sdk su RubyGems. Il codice sorgente e il changelog si trovano in didit-protocol/sdk-ruby su GitHub. Oppure aggiungi gem "didit-sdk" al tuo Gemfile ed esegui bundle install. Caricalo con require "didit".

Configurare il client

Didit::Client.new legge DIDIT_API_KEY dalle variabili d’ambiente. Passa dei keyword argument per sovrascriverla, oppure per impostare gli ID di organizzazione e applicazione che le chiamate con ambito applicazione (casi, reti, report normativi) richiedono. I campi della richiesta sono keyword argument con i nomi propri dell’API; le risposte sono oggetti con un metodo di lettura per ogni campo, [:field] e to_h.

Creare una sessione

Crea una sessione di verifica per un workflow e invia il tuo utente al suo URL.

Leggere la decisione

Quando l’utente completa la procedura (oppure quando arriva il webhook), leggi la decisione. Ogni risultato di una funzionalità è una lista con una voce per ogni nodo del workflow.

Verificare un webhook

Passa il corpo grezzo, esattamente come ricevuto, e le intestazioni della richiesta. verify genera Didit::WebhookVerificationError per qualsiasi consegna che non sia valida e recente, e altrimenti restituisce un evento tipizzato.
In Rails, chiama handle_webhook(request.raw_post, request.headers). Durante la rotazione del segreto, passa entrambi: [new_secret, old_secret]. Consulta Webhook per gli eventi e lo schema di firma.

Sottoporre a screening una transazione

Invia un pagamento, un prelievo o un trasferimento di criptovaluta al monitoraggio delle transazioni; la risposta contiene il suo stato e il punteggio di rischio.

Verificare i token di Authentication

Didit::Authentication verifica i token di accesso firmati dal tuo emittente di Authentication, nel tuo backend, senza chiamare Didit per ogni richiesta. Inoltre scambia codici, aggiorna i token, controlla e revoca le sessioni ed esegue gli step-up.
La verifica dei token esegue i controlli descritti in Verificare un token sul tuo server, con l’emittente e le chiavi di firma della tua applicazione.

Errori

Elenchi e file

Le pagine degli endpoint server del riferimento API includono un esempio in Ruby per la rispettiva operazione, eccetto per gli endpoint e i campi che nessuna release 1.0.1 include ancora, indicati nella panoramica.
Ultima modifica il 7 novembre 2026