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

> ## Agent Instructions
> Utilisez l'API Maketou v1 décrite par la spécification OpenAPI de ce site.
> Gardez la clé API côté serveur et ne l'exposez jamais dans du code client, des logs ou une réponse destinée au navigateur.
> Ne livrez un produit et n'activez un accès que lorsque le statut du panier est `completed`.
> N'inventez pas d'endpoint, de champ ou de webhook absent de la documentation.

# AGENTS.md

> Ajoutez les règles essentielles de l'API Maketou aux instructions de votre projet.

Un fichier `AGENTS.md` donne aux assistants IA des instructions propres à votre projet.

Ajoutez l'extrait suivant à votre fichier `AGENTS.md` à la racine du projet.

```markdown theme={null}
## Intégration de l'API Maketou

- Utilisez la documentation officielle : https://docs-api.maketou.com/llms.txt
- Utilisez la spécification OpenAPI : https://docs-api.maketou.com/openapi.yaml
- Utilisez l'URL de base `https://api.maketou.net`.
- Effectuez toutes les requêtes Maketou depuis le backend.
- Stockez la clé API dans un gestionnaire de secrets ou une variable d'environnement.
- Ne placez jamais la clé API dans le frontend, les logs ou le dépôt Git.
- Envoyez la clé avec `Authorization: Bearer YOUR_API_KEY`.
- Créez un panier avec `POST /api/v1/stores/cart/checkout`.
- Un panier Maketou contient actuellement un seul produit.
- Conservez l'identifiant du panier et utilisez la `redirectUrl` retournée par l'API.
- Vérifiez le panier avec `GET /api/v1/stores/cart/{cartId}`.
- Livrez le produit ou activez l'accès uniquement si le statut est `completed`.
- Gérez `waiting_payment`, `completed`, `abandoned` et `payment_failed`.
- Gérez les réponses `400`, `401`, `404`, `422` et `429` selon l'endpoint.
- En cas de réponse `429`, respectez le header `Retry-After`.
- Utilisez `customerPrice` uniquement pour un produit configuré en prix libre.
- N'inventez aucun endpoint, champ ou webhook absent de la documentation.
```

## Pourquoi l'ajouter ?

Ces règles restent disponibles pendant les tâches de développement. Elles réduisent les erreurs fréquentes, comme l'exposition d'une clé API ou la livraison d'un produit avant la confirmation du paiement.

<Tip>
  Combinez `AGENTS.md` avec le [serveur MCP](/ai/mcp-server) pour donner à l'assistant des règles locales et un accès à la documentation à jour.
</Tip>