# Intégrer nouko avec un assistant IA

> Ressources lisibles par les modèles (llms.txt, Markdown, OpenAPI) et prompt prêt à coller pour intégrer nouko avec un assistant de code.

Source : https://nouko.openclouds.fr/docs/guide-ia

Cette documentation est conçue pour être lue aussi bien par vous que par un assistant de code (Cursor, Claude, ChatGPT, Copilot…).

| Ressource | Contenu |
| --- | --- |
| [/llms.txt](https://nouko.openclouds.fr/llms.txt) | Index court de la documentation |
| [/llms-full.txt](https://nouko.openclouds.fr/llms-full.txt) | Toute la documentation en un seul fichier Markdown |
| `/docs/<page>.md` | Chaque page en Markdown, par exemple [/docs/sessions.md](https://nouko.openclouds.fr/docs/sessions.md) |
| [/nouko-openapi.json](https://nouko.openclouds.fr/nouko-openapi.json) | Contrat OpenAPI 3.1 (points d’entrée, schémas, webhooks) |

Sur chaque page, le bouton **Copier pour une IA** copie la page en Markdown.

## Prompt prêt à coller

```
Tu vas intégrer l'API de vérification d'identité nouko dans mon application.
Lis d'abord la documentation complète : https://nouko.openclouds.fr/llms-full.txt
et le contrat OpenAPI : https://nouko.openclouds.fr/nouko-openapi.json

Règles à respecter :
- La clé API (nk_test_… / nk_live_…) reste côté serveur, dans une variable d'environnement NOUKO_API_KEY.
- Chaque POST /v1/sessions envoie un en-tête Idempotency-Key stable (ex. l'identifiant de commande).
- Redirige l'utilisateur vers verification_url ; au retour sur redirect_url, n'accorde rien :
  la décision vient uniquement du webhook signé ou de GET /v1/sessions/{id}/decision.
- Le webhook lit le corps brut, vérifie Nouko-Signature (HMAC-SHA256, tolérance 300 s),
  répond 2xx en moins de 8 s, puis traite en arrière-plan en dédoublonnant sur event.id.
- Commence en sandbox avec les références test_approve / test_decline / test_review / test_expire.
- N'invente aucun point d'entrée ou champ absent de la documentation.

Mon stack : <décris ton langage, ton framework et ta base de données>
```

> **Attention :** Relisez toujours le code généré, en particulier la vérification de signature et l’endroit où la clé API est stockée.