# nouko

> API de vérification d’identité (KYC) avec revue humaine pour le Bénin et la Côte d’Ivoire : sessions, lien de collecte hébergé, webhooks signés HMAC, sandbox à scénarios.

URL de base de l’API : https://nouko.openclouds.fr/api/public. Authentification : `Authorization: Bearer nk_test_…` (sandbox) ou `nk_live_…` (production). Toute création de session exige un en-tête `Idempotency-Key`. La décision fait foi uniquement via webhook signé ou `GET /v1/sessions/{id}/decision`.

## Commencer

- [Documentation API nouko](https://nouko.openclouds.fr/docs.md): 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.
- [Démarrage rapide](https://nouko.openclouds.fr/docs/demarrage.md): Créez votre première session de vérification nouko en sandbox, ouvrez le parcours client et recevez le webhook en 5 minutes.
- [Authentification](https://nouko.openclouds.fr/docs/authentification.md): Clés API nouko nk_test_ et nk_live_, en-tête Bearer, séparation sandbox / production et bonnes pratiques de sécurité.

## Référence

- [Sessions](https://nouko.openclouds.fr/docs/sessions.md): Référence de l’API sessions nouko : créer une session, lire son statut, lister avec pagination, annuler et obtenir la décision motivée.
- [Webhooks](https://nouko.openclouds.fr/docs/webhooks.md): Événements webhook nouko, contenu envoyé, 6 essais automatiques, rejeu 30 jours et récepteurs prêts à l’emploi en Node.js, Python, PHP et Go.
- [Vérifier la signature des webhooks](https://nouko.openclouds.fr/docs/signature.md): Vérifiez l’en-tête Nouko-Signature (HMAC-SHA256) en Node.js, Python, PHP, Go, Java et Ruby, avec les pièges à éviter.

## Guides

- [Sandbox et scénarios de test](https://nouko.openclouds.fr/docs/sandbox.md): Testez votre intégration nouko sans données réelles : scénarios test_approve, test_decline, test_review, test_expire et parcours client de test.
- [Erreurs, idempotence et limites](https://nouko.openclouds.fr/docs/erreurs.md): Codes d’erreur de l’API nouko, idempotence avec Idempotency-Key et limite de 120 requêtes par minute.
- [Intégrer nouko avec un assistant IA](https://nouko.openclouds.fr/docs/guide-ia.md): Ressources lisibles par les modèles (llms.txt, Markdown, OpenAPI) et prompt prêt à coller pour intégrer nouko avec un assistant de code.

## Contrat

- [OpenAPI 3.1](https://nouko.openclouds.fr/nouko-openapi.json): points d’entrée, schémas et webhooks

## Optional

- [Documentation complète](https://nouko.openclouds.fr/llms-full.txt): toutes les pages en un fichier