Les guildes aussi veulent leurs soirées de contes. Elles ont déjà leurs parchemins magiques pour réserver une table : elles veulent maintenant consulter les soirées et inscrire leurs membres, sans passer par le site.
Le cahier des charges
GET /api/soirees (sans sceau)
Les soirées à venir, de la plus proche à la plus lointaine, en JSON :
[ { "id": 2, "titre": "La chute de Gondolin", "conteur": "Galadriel", "debut": "2026-10-20T20:30:00+00:00", "places": 12, "placesRestantes": 8, "complet": false } ]
POST /api/soirees/{id}/inscriptions (avec le sceau d'une guilde : Authorization: Bearer …)
Le corps : {"nom": "Legolas", "email": "legolas@foret-noire.me", "personnes": 2}.
| Situation | Réponse |
|---|---|
| inscription acceptée | 201, avec l'inscription (id, nom, personnes) et la soirée à jour (soiree, au format de la liste) ; le parchemin part, comme sur le site |
| plus assez de places | 409, avec « Plus assez de places : il en reste 1. » |
| données invalides, ou adresse déjà inscrite | 422, avec le message de la règle |
| sans sceau, ou avec un faux | 401 |
| soirée inconnue | 404 |
Dans tous les cas refusés, rien n'est enregistré.
L'onglet Requêtes de l'aperçu contient des exemples prêts à l'emploi, avec le sceau des Lames d'Argent.