# Documentation API nouko

> Intégrez la vérification d’identité (KYC) avec revue humaine de nouko : sessions, webhooks signés, sandbox et exemples de code prêts à l’emploi.

Source : https://nouko.openclouds.fr/docs

L’API nouko vous permet de vérifier l’identité de vos clients au Bénin et en Côte d’Ivoire sans gérer vous-même les pièces d’identité. Vous créez une **session** depuis votre serveur, votre client suit un parcours sécurisé sur son téléphone, et vous recevez la décision par **webhook signé**.

> **Note :** Une personne examine chaque cas ambigu. Un fournisseur indisponible n’entraîne jamais de refus automatique : le dossier passe en revue manuelle.

- [Démarrage rapide](https://nouko.openclouds.fr/docs/demarrage) : Votre première session de test en 5 minutes.
- [Référence des sessions](https://nouko.openclouds.fr/docs/sessions) : Créer, lire, lister, annuler, obtenir la décision.
- [Webhooks](https://nouko.openclouds.fr/docs/webhooks) : Événements, réessais, signature HMAC.

## Fonctionnement

**Flux complet**

```
Votre serveur ──POST /v1/sessions──────────▶ nouko   → id + verification_url
Votre client  ──ouvre verification_url────▶ nouko   → consentement, pièces, selfie
nouko         ──contrôles + revue humaine
nouko         ──webhook signé session.*───▶ votre serveur
Votre serveur ──GET /v1/sessions/{id}/decision──▶ décision motivée
```

## L’essentiel

| Élément | Valeur |
| --- | --- |
| URL de base | `https://nouko.openclouds.fr/api/public` |
| Format | JSON (UTF-8), dates ISO 8601 en UTC |
| Authentification | `Authorization: Bearer nk_test_…` ou `nk_live_…` |
| Limite | 120 requêtes par minute et par clé |
| Pays | `BJ` (Bénin), `CI` (Côte d’Ivoire) |
| Contrat machine | [OpenAPI 3.1](https://nouko.openclouds.fr/nouko-openapi.json) |
| Pour les assistants IA | [llms.txt](https://nouko.openclouds.fr/llms.txt) · [llms-full.txt](https://nouko.openclouds.fr/llms-full.txt) · chaque page en `.md` |