Pour les développeurs
API REST v1
Les opérations de l’API réutilisent les services et les permissions de l’interface web. Créez un jeton depuis Mon compte, puis envoyez-le dans Authorization: Bearer VOTRE_JETON.
Les jetons « Lecture seule » ne peuvent effectuer aucune mutation. Avec une session par cookie, récupérez le jeton CSRF via GET /api/v1/auth/csrf et ajoutez l’en-tête X-CSRF-Token aux opérations POST, PATCH, PUT et DELETE.
Les formulaires d’authentification utilisent une session et un jeton CSRF, y compris lors de l’inscription. Les uploads utilisent multipart/form-data avec un champ file. La publication exige une adresse vérifiée si la configuration le prévoit.
Télécharger la spécification OpenAPI
Codes de réponse
200/201 : succès ; 401 : connexion requise ; 403 : droit insuffisant ou CSRF ; 404 : ressource inexistante ou inaccessible ; 409 : conflit ; 422 : validation ; 429 : limite de débit.
Routes enregistrées
| Méthode | Chemin |
|---|---|
GET | /api/v1/auth/csrf |
POST | /api/v1/auth/login |
POST | /api/v1/auth/register |
POST | /api/v1/auth/logout |
POST | /api/v1/auth/mfa |
POST | /api/v1/auth/forgot |
POST | /api/v1/auth/reset |
POST | /api/v1/auth/verify |
POST | /api/v1/auth/resend |
GET | /api/v1/me |
PATCH | /api/v1/me |
GET | /api/v1/profiles/{username} |
POST | /api/v1/me/avatar |
POST | /api/v1/me/password |
POST | /api/v1/me/email |
POST | /api/v1/me/email/confirm |
POST | /api/v1/me/totp/setup |
POST | /api/v1/me/totp/enable |
POST | /api/v1/me/totp/disable |
POST | /api/v1/me/tokens |
DELETE | /api/v1/me/tokens/{id} |
DELETE | /api/v1/me/sessions/{id} |
DELETE | /api/v1/me/sessions |
GET | /api/v1/search |
GET | /api/v1/search/suggestions |
POST | /api/v1/media |
GET | /api/openapi.json |
GET | /api/v1/messages |
POST | /api/v1/messages |
GET | /api/v1/messages/{id} |
POST | /api/v1/messages/{id}/reply |
POST | /api/v1/messages/{id}/read |
POST | /api/v1/messages/{id}/archive |
POST | /api/v1/messages/{id}/unarchive |
DELETE | /api/v1/messages/{id} |
POST | /api/v1/messages/{id}/leave |
POST | /api/v1/private-messages/{id}/report |
GET | /api/v1/notifications |
GET | /api/v1/notifications/counts |
GET | /api/v1/notifications/preferences |
PUT | /api/v1/notifications/preferences |
POST | /api/v1/notifications/read-all |
POST | /api/v1/notifications/{id}/read |
GET | /api/v1/blocks |
POST | /api/v1/blocks |
DELETE | /api/v1/blocks/{id} |
GET | /api/v1/moderation/private-messages |
POST | /api/v1/moderation/private-messages/{id} |
GET | /api/v1/forums |
GET | /api/v1/forums/followed |
GET | /api/v1/forums/drafts |
POST | /api/v1/forums/drafts |
DELETE | /api/v1/forums/drafts/{id} |
GET | /api/v1/forums/{id} |
POST | /api/v1/forums/{id}/topics |
GET | /api/v1/topics/{id} |
POST | /api/v1/topics/{id}/posts |
POST | /api/v1/topics/{id}/actions |
POST | /api/v1/topics/{id}/follow |
GET | /api/v1/posts/{id} |
PATCH | /api/v1/posts/{id} |
POST | /api/v1/posts/{id}/actions |
GET | /api/v1/posts/{id}/revisions |
POST | /api/v1/preview |
POST | /api/v1/reports/{type}/{id} |
GET | /api/v1/moderation |
POST | /api/v1/moderation/reports/{id} |
POST | /api/v1/moderation/sanctions |
POST | /api/v1/moderation/sanctions/{id}/revoke |
POST | /api/v1/moderation/appeals/{id} |
GET | /api/v1/moderation/forums/{id}/history |
GET | /api/v1/me/sanctions |
POST | /api/v1/me/sanctions/{id}/appeal |
GET | /api/v1/admin/forums |
POST | /api/v1/admin/forums |
PUT | /api/v1/admin/forums/{id} |
POST | /api/v1/admin/forum-categories |
PUT | /api/v1/admin/forum-categories/{id} |
GET | /api/v1/admin/forums/{id}/members |
POST | /api/v1/admin/forums/{id}/members |
DELETE | /api/v1/admin/forums/{id} |
DELETE | /api/v1/admin/forum-categories/{id} |
GET | /api/v1/articles |
GET | /api/v1/articles/{id} |
GET | /api/v1/games |
GET | /api/v1/games/{id} |
GET | /api/v1/editorial/articles |
GET | /api/v1/editorial/articles/{id} |
POST | /api/v1/articles |
PUT | /api/v1/articles/{id} |
PATCH | /api/v1/articles/{id} |
DELETE | /api/v1/articles/{id} |
POST | /api/v1/articles/{id}/restore |
GET | /api/v1/articles/{id}/revisions |
POST | /api/v1/articles/{id}/revisions/{revision}/restore |
GET | /api/v1/editorial/games |
GET | /api/v1/editorial/games/{id} |
POST | /api/v1/games |
PUT | /api/v1/games/{id} |
PATCH | /api/v1/games/{id} |
DELETE | /api/v1/games/{id} |
POST | /api/v1/games/{id}/restore |
POST | /api/v1/games/{id}/media |
DELETE | /api/v1/games/{id}/media/{media} |
GET | /api/v1/taxonomies |
POST | /api/v1/taxonomies/{type} |
PUT | /api/v1/taxonomies/{type}/{id} |
DELETE | /api/v1/taxonomies/{type}/{id} |
GET | /api/v1/games/{id}/reviews |
POST | /api/v1/games/{id}/reviews |
PUT | /api/v1/games/{id}/reviews/mine |
DELETE | /api/v1/reviews/{id} |
POST | /api/v1/reviews/{id}/votes |
GET | /api/v1/articles/{id}/comments |
POST | /api/v1/articles/{id}/comments |
PATCH | /api/v1/articles/{id}/comments/{comment} |
DELETE | /api/v1/comments/{id} |
POST | /api/v1/comments/{id}/votes |
POST | /api/v1/content/{type}/{id}/reports |
GET | /api/v1/content/reports |
POST | /api/v1/content/reports/{id}/resolve |
GET | /api/v1/admin |
GET | /api/v1/admin/users |
GET | /api/v1/admin/users/{id} |
GET | /api/v1/admin/permissions |
GET | /api/v1/admin/settings |
GET | /api/v1/admin/audit |
GET | /api/v1/admin/security |
GET | /api/v1/admin/jobs |
GET | /api/v1/admin/media |
GET | /api/v1/admin/badges |
PATCH | /api/v1/admin/users/{id} |
POST | /api/v1/admin/users/{id}/revoke-sessions |
PUT | /api/v1/admin/permissions/{role} |
PATCH | /api/v1/admin/settings |
POST | /api/v1/admin/jobs/{id}/retry |
POST | /api/v1/admin/media |
DELETE | /api/v1/admin/media/{id} |
POST | /api/v1/admin/media/{id}/restore |
POST | /api/v1/admin/badges |
PUT | /api/v1/admin/badges/{id} |
DELETE | /api/v1/admin/badges/{id} |
POST | /api/v1/admin/users/{id}/badges |
GET | /api/v1/admin/levels |
POST | /api/v1/admin/levels |
DELETE | /api/v1/admin/levels/{id} |