Initial commit

docs/API.md

@@ -0,0 +1,42 @@
+# Spécification API
+
+Décrit les conventions d’API côté backend et les règles de compatibilité.
+
+---
+
+## Légende des zones
+- `<A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)` : à compléter par toi selon le projet.
+- `<A COMPLETER PAR AGENT>` : à compléter par un agent spécialisé backend.
+
+---
+
+## 1. Versioning
+- Stratégie (URL, header, autre) : <A COMPLETER PAR AGENT>
+- Politique de dépréciation : <A COMPLETER PAR AGENT>
+
+## 2. Authentification
+- Méthode (JWT = jeton, session, OAuth = délégation d’accès) : <A COMPLETER PAR AGENT>
+- Durée de session / refresh : <A COMPLETER PAR AGENT>
+
+## 3. Conventions HTTP
+- Codes d’erreurs : <A COMPLETER PAR AGENT>
+- Idempotence (appel sans effet si répété) : <A COMPLETER PAR AGENT>
+- Pagination : <A COMPLETER PAR AGENT>
+- Tri/filtre : <A COMPLETER PAR AGENT>
+
+## 4. Formats
+- Format JSON : <A COMPLETER PAR AGENT>
+- Dates / timezone : <A COMPLETER PAR AGENT>
+- Naming (camelCase, snake_case) : <A COMPLETER PAR AGENT>
+
+## 5. Contrats
+- Erreurs : `contracts/errors.md`
+- Pagination : `contracts/pagination.md`
+- Modèle de données : `contracts/data_model.md`
+
+---
+
+## Exemple (a supprimer)
+- Versioning : `/api/v1`.
+- Dates : ISO-8601 en UTC.
+- Erreurs : `{ "error": { "code": "VALIDATION_ERROR" } }`.