Docs / Intégrer avec une IA
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.
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 | Index court de la documentation |
| /llms-full.txt | Toute la documentation en un seul fichier Markdown |
/docs/<page>.md | Chaque page en Markdown, par exemple /docs/sessions.md |
| /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>Relisez toujours le code généré, en particulier la vérification de signature et l’endroit où la clé API est stockée.