net/http de la bibliothèque standard. Consultez la vue d’ensemble des SDK serveur pour connaître les éléments communs à tous les SDK.
Installation
didit-sdk sur RubyGems. Son code source et son journal des modifications sont disponibles dans didit-protocol/sdk-ruby sur GitHub.
Vous pouvez aussi ajouter gem "didit-sdk" à votre Gemfile et exécuter bundle install. Chargez-la avec require "didit".
Configurer le client
Didit::Client.new lit DIDIT_API_KEY depuis l’environnement. Passez des arguments nommés pour le remplacer, ou pour définir les identifiants d’organisation et d’application dont ont besoin les appels à portée d’application (dossiers, réseaux, rapports réglementaires). Les champs de requête sont des arguments nommés portant les noms propres à l’API ; les réponses sont des objets dotés d’un accesseur par champ, [:field] et to_h.
Créer une session
Créez une session de vérification pour un workflow et redirigez votre utilisateur vers son URL.Lire la décision
Lorsque l’utilisateur a terminé (ou dès que le webhook arrive), lisez la décision. Chaque résultat de fonctionnalité est une liste contenant une entrée par nœud du workflow.Vérifier un webhook
Transmettez le corps brut, tel que reçu, et les en-têtes de la requête.verify lève Didit::WebhookVerificationError pour toute livraison qui n’est pas à la fois valide et récente, et renvoie un événement webhook typé dans le cas contraire.
handle_webhook(request.raw_post, request.headers). Pendant la rotation du secret, transmettez les deux : [new_secret, old_secret]. Consultez Webhooks pour les événements et le schéma de signature.
Filtrer une transaction
Soumettez un paiement, un retrait ou un transfert de crypto-actifs à la surveillance des transactions ; la réponse contient son statut et son score de risque.Vérifier les tokens Authentication
Didit::Authentication vérifie, côté backend et sans appeler Didit à chaque requête, les tokens d’accès signés par votre émetteur Authentication. Elle permet aussi d’échanger des codes, de rafraîchir les tokens, de vérifier et révoquer des sessions, et de lancer des étapes de renforcement.
La vérification des tokens effectue les contrôles décrits dans Vérifier un token sur votre serveur, avec l’émetteur et les clés de signature de votre application.