Passer au contenu principal
Démarrage rapide et stratégie API pour les développeurs

1. Authentification

Toutes les requêtes API doivent être authentifiées via des jetons Bearer.
  • Clés API : Émises via la Console du locataire (Sécurité > Clés API).
  • Portées: Les clés sont limitées à des actions spécifiques (par exemple, mint, verify, read_audit).
  • Rotation: Nous recommandons une politique de rotation de 90 jours. Invalidez immédiatement les clés via le point de terminaison DELETE en cas de compromission.

2. Le flux de frappe

Pour émettre une attestation, POSTez une charge utile JSON à /v1/attestations/mint.

3. Webhooks et événements

Truthlocks utilise des webhooks pour notifier votre système des changements d’état. Vérification : Vérifiez toujours l’en-tête X-Truthlocks-Signature en utilisant le secret partagé de votre point de terminaison. Consultez le guide des webhooks pour tous les détails sur les types d’événements, la vérification de la signature et le comportement de réessai.

4. Bundles de preuves

Un bundle de preuves est un objet JSON signé contenant :
  1. Données originales : La charge utile que vous avez frappée.
  2. Signature de l’émetteur : Votre preuve cryptographique d’intention.
  3. Point de contrôle de la plateforme : Preuve de Truthlocks de l’état du réseau au moment de la frappe.

5. Limites de débit et quotas

Les limites sont appliquées par locataire en fonction de votre niveau d’abonnement :
  • Rafale globale : 500 requêtes par 10 secondes.
  • Quota de frappe mensuel: Défini dans votre accord d’entreprise (visible dans /v1/billing/usage).

6. Séparation des environnements

Nous proposons deux environnements distincts :
  • Bac à sable (sandbox.truthlocks.com): Pour les tests avec des clés fictives et des données éphémères.
  • Production (api.truthlocks.com): Fédérée pour l’émission à enjeux élevés.
Utilisez nos SDK pour gérer les tentatives, la vérification de signature et sérialisation de la charge utile automatiquement.