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 :- Données originales : La charge utile que vous avez frappée.
- Signature de l’émetteur : Votre preuve cryptographique d’intention.
- 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.

