Saltar al contingut principal
El gem oficial de Didit per a Ruby. Requereix Ruby 3.1 o posterior i utilitza net/http de la biblioteca estàndard. Consulta la visió general dels SDK de servidor per veure què comparteix cada SDK.

Instal·lació

El gem és didit-sdk a RubyGems. El codi font i el registre de canvis es troben a didit-protocol/sdk-ruby a GitHub. També pots afegir gem "didit-sdk" al teu Gemfile i executar bundle install. Carrega’l amb require "didit".

Configura el client

Didit::Client.new llegeix DIDIT_API_KEY de l’entorn. Passa arguments amb paraula clau per substituir-la, o per definir els identificadors d’organització i d’aplicació que necessiten les crides amb abast d’aplicació (casos, xarxes, informes regulatoris). Els camps de les sol·licituds són arguments amb paraula clau amb els noms propis de l’API; les respostes són objectes amb un lector per camp, [:field] i to_h.

Crea una sessió

Crea una sessió de verificació per a un flux de treball i envia el teu usuari a la seva URL.

Llegeix la decisió

Quan l’usuari acabi (o quan arribi el webhook), llegeix la decisió. Cada resultat de funcionalitat és una llista amb una entrada per cada node del flux de treball.

Verifica un webhook

Passa el cos brut, exactament tal com s’ha rebut, i les capçaleres de la sol·licitud. verify llança Didit::WebhookVerificationError per a qualsevol lliurament que no sigui vàlid i recent, i en cas contrari retorna un esdeveniment tipat.
A Rails, crida handle_webhook(request.raw_post, request.headers). Mentre rotes el secret, passa’n tots dos: [new_secret, old_secret]. Consulta Webhooks per veure els esdeveniments i l’esquema de signatura.

Cribra una transacció

Envia un pagament, una retirada o una transferència de criptoactius al monitoratge de transaccions; la resposta inclou l’estat i la puntuació de risc.

Verifica els tokens d’Authentication

Didit::Authentication comprova els tokens d’accés que signa el teu emissor d’Authentication, al teu backend, sense cridar Didit a cada sol·licitud. També intercanvia codis, renova tokens, comprova i revoca sessions, i executa verificacions reforçades.
La verificació de tokens realitza les comprovacions descrites a Verifica un token al teu servidor, contra l’emissor i les claus de signatura de la teva aplicació.

Errors

Llistes i fitxers

Les pàgines d’endpoints de servidor de la referència de l’API tenen un exemple en Ruby per a la seva operació, excepte els endpoints i els camps que cap versió 1.0.1 encara no té, que s’indiquen a la visió general.
Darrera modificació el 7 de novembre del 2026