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éthodeChemin
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}

Confirmer cette action