> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pack d'intégration technique

> Démarrage rapide et stratégie API du développeur

**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`.

```json theme={null}
{
  "template_key": "academic_transcript",
  "payload": {
    "student_id": "STU123",
    "gpa": "3.8"
  },
  "recipient_email": "student@university.edu"
}
```

## 3. Webhooks et événements

Truthlocks utilise des webhooks pour notifier votre système des changements d'état.

| Type d'événement | Description |
| :- | :- |
| `attestation.created` | Déclenché lorsque la plateforme a signé l'enregistrement. |
| `issuer.suspended` | Déclenché si la cote de confiance de l'émetteur change. |
| `billing.usage.threshold` | Déclenché lorsqu'un seuil d'utilisation est atteint. |

**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](https://docs.truthlocks.com/fr/guides/webhooks.md) 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.

> [!TIP]
>
> Utilisez nos [SDK](https://docs.truthlocks.com/fr/sdk/js.md) pour gérer les tentatives, la vérification de signature et
> sérialisation de la charge utile automatiquement.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.