{"openapi":"3.1.0","info":{"title":"API de VDM","version":"2.0","description":"L'API de Vie de merde : les VDM publiées, leurs commentaires, les membres. Documentation : https://apps.viedemerde.fr/docs\n\nCodes d'erreur (`error` : « code - message ») :\n\n- 1 ERR_ARTICLE_NOT_PROVIDED: No article provided.\n\n- 2 ERR_ARTICLE_NOT_FOUND: Article not found.\n\n- 3 ERR_ARTICLE_CONTENT_MISSING: No article content provided.\n\n- 4 ERR_ARTICLE_CONTENT_TOOSHORT: Article content must be between 20 and 300 characters long.\n\n- 5 ERR_COMMENT_NOT_PROVIDED: No comment content provided.\n\n- 6 ERR_COMMENT_NOT_FOUND: Comment not found.\n\n- 7 ERR_COMMENT_CONTENT_MISSING: No comment content provided.\n\n- 8 ERR_COMMENT_CONTENT_INVALID: Comment content must be between 20 and 300 characters long.\n\n- 9 ERR_MISSING_PARAM: Missing parameter\n\n- 10 ERR_USER_NOT_FOUND: This user not found.\n\n- 11 ERR_USER_USERNAME_ALREADY_EXIT: This username is already associated with an account.\n\n- 12 ERR_USER_EMAIL_ALREADY_EXIT: This email is already associated with an account.\n\n- 13 ERR_USER_EMAIL_INVALID: This email is not valid.\n\n- 14 ERR_USER_ABOUT_ME_INVALID: About me content can not exceed more 300 characters long.\n\n- 15 ERR_USER_IMAGE_IS_TO_LARGE: The file is too large. Allowed maximum size is 1 MB.\n\n- 16 ERR_USER_MISSING_CONFIRM_PASSWORD_FIELD: Field confirm_password is missing.\n\n- 17 ERR_USER_PASSWORD_FIELDS_MUST_MATCH: The password fields must match.\n\n- 18 ERR_USER_ALREADY_LIKED: You have already liked this user.\n\n- 21 ERR_ARTICLE_EMAIL_REQUIRED: You need to provide an email address\n\n- 23 ERR_ARTICLE_ALREADY_VOTED: Article already voted\n\n- 25 ERR_SUPPORT_INVALID_SUBJECT: Invalid subject provided\n\n- 26 ERR_SUPPORT_INVALID_MESSAGE: Invalid message provided\n\n- 27 ERR_MEDIA_IMAGE_NOT_FOUND: Image not found.\n\n- 28 ERR_BADGE_NOT_FOUND: Badge not found.\n\n- 29 ERR_VOTETYPE_INVALID: Provided vote type is invalid\n\n- 30 ERR_TWITTER_INVALID_INFOS: Missing datas for twitter connect\n\n- 31 ERR_TIMELINE_ALREADY_LIKED: User already liked this post\n\n- 32 ERR_USER_ACCOUNT_IS_BANNED: User account is banned\n\n- 33 ERR_USER_NOT_COMMENT_OWNER: User does not own comment\n\n- 34 ERR_USER_ACCOUNT_NOT_VALIDATED: You need to validate your account, check your emails.\n\n- 35 ERR_FACEBOOK_INVALID_INFOS: Missing datas for facebook connect\n\n- 99 ERR_UNKNOWN: Unknown error\n\n- 100 ERR_UNAUTHORIZED: You must be authenticated in order to access this function.\n\n- 102 ERR_INVALID_KEY: Invalid API key.\n\n- 103 ERR_INVALID_LOGIN: Invalid login credentials.\n\n- 104 ERR_INVALID_TOKEN: Invalid or expired API token."},"externalDocs":{"url":"https://apps.viedemerde.fr/docs"},"servers":[{"url":"https://www.viedemerde.fr/api/v2"}],"tags":[{"name":"general","description":"Général"},{"name":"users","description":"Membres"},{"name":"articles","description":"VDM"},{"name":"comments","description":"Commentaires"},{"name":"badges","description":"Badges"}],"paths":{"/":{"get":{"operationId":"api_infos","tags":["general"],"summary":"Obtenir les informations de l’API","description":"Permet de vérifier que l’API répond et que votre clé d’API est acceptée. Renvoie `version`, `apikey` et `userid` : l’id du membre authentifié, sinon la valeur de `X-VDM-Uniqid`, sinon `unknown`.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"version":"2.0","apikey":"{{apikey}}","userid":"1139668301","meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/appconfig":{"get":{"operationId":"api_appconfig","tags":["general"],"summary":"Obtenir la configuration de l’application","description":"Renvoie un objet de configuration dans `data`, pouvant être mis en cache 24 heures. Il contient au plus, pour l’instant, un booléen `contest` (un concours de VDM est-il en cours ?) et peut être vide.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"contest":false},"meta":{},"badge":[],"badge_display":[]}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/support":{"post":{"operationId":"api_support","tags":["general"],"summary":"Envoyer un message au support","description":"Si vous êtes authentifié, le pseudo et l’e-mail du membre servent d’expéditeur. Sinon, `username` doit être une adresse e-mail valide. Le sujet est préfixé par la description de votre clé d’API. Renvoie 202 en cas de succès, 400 si l’e-mail, le sujet ou le message manque ou est invalide.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"chaîne, POST — adresse e-mail de l’expéditeur (obligatoire sans authentification, ignorée sinon)"},"subject":{"type":"string","description":"chaîne, POST, obligatoire — sujet du message"},"message":{"type":"string","description":"chaîne, POST, obligatoire — corps du message"}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"chaîne, POST — adresse e-mail de l’expéditeur (obligatoire sans authentification, ignorée sinon)"},"subject":{"type":"string","description":"chaîne, POST, obligatoire — sujet du message"},"message":{"type":"string","description":"chaîne, POST, obligatoire — corps du message"}}}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":null,"meta":{},"badge":[],"badge_display":[]}}}},"400":{"description":"Erreur","content":{"application/json":{"example":"{\n  \"data\": [\n    \"Invalid message provided\"\n  ],\n  \"meta\": {}\n}\n----\n{\n  \"data\": [\n    \"Invalid subject provided\"\n  ],\n  \"meta\": {}\n}\n----\n{\n  \"data\": [\n    \"Invalid message provided\"\n  ],\n  \"meta\": {}\n}"}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/discover/{service}":{"get":{"operationId":"api_discover","tags":["general"],"summary":"Découvrir des profils de membres","description":"Renvoie les membres actifs ayant une photo de profil, inscrits depuis moins de `created` mois, avec pagination (`meta`). Le membre authentifié est exclu. Sans service (`/discover`) et avec `favorite`, `birthday` et `random`, un jeton utilisateur est obligatoire (401 sinon) ; `lastprofiles`, `lastpictures`, `lastbirthdays` et `followed` fonctionnent aussi en anonyme. `lat`/`long` ne s’appliquent qu’avec authentification, et ce filtre de localisation renvoie actuellement une erreur serveur. Exemple : `/discover/lastprofiles?gender=woman&relation[]=single&agemin=19&agemax=50&page[number]=1&page[bypage]=10`.","parameters":[{"name":"service","in":"path","required":true,"schema":{"type":"string","enum":["favorite","birthday","lastprofiles","lastpictures","lastbirthdays","random","followed"]}},{"name":"service","in":"query","description":"chaîne, facultative, dans le chemin — `favorite` (ordre aléatoire pour l’instant), `birthday` (membres nés le même jour que vous), `lastprofiles` (derniers inscrits d’abord), `lastpictures` (dernières photos de profil d’abord), `lastbirthdays` (membres dont c’est l’anniversaire aujourd’hui), `random` (ordre aléatoire) ou `followed` (les plus suivis d’abord). Sans service : derniers inscrits d’abord","schema":{"type":"string"}},{"name":"lat","in":"query","description":"nombre décimal ou `auto`, facultatif — latitude du centre de la zone de recherche (environ ±0,66°) ; `auto` utilise votre ville. À utiliser avec `long`","schema":{"type":"string"}},{"name":"long","in":"query","description":"nombre décimal ou `auto`, facultatif — longitude du centre de la zone de recherche (environ ±0,66°) ; `auto` utilise votre ville. À utiliser avec `lat`","schema":{"type":"string"}},{"name":"gender","in":"query","description":"`man` ou `woman`, facultatif — genre des profils, d’après leur civilité","schema":{"type":"string"}},{"name":"relation","in":"query","description":"tableau de chaînes, facultatif — situations amoureuses à inclure : `single`, `couple`, `complicated` (ex. `relation[]=single&relation[]=couple`)","schema":{"type":"string"}},{"name":"agemin","in":"query","description":"entier, facultatif — âge minimum","schema":{"type":"string"}},{"name":"agemax","in":"query","description":"entier, facultatif — âge maximum","schema":{"type":"string"}},{"name":"created","in":"query","description":"entier, 24 par défaut — uniquement les profils créés depuis moins de ce nombre de mois","schema":{"type":"string"}},{"name":"random","in":"query","description":"booléen, false par défaut — renvoie les résultats dans un ordre aléatoire ; toute valeur non vide autre que `0` l’active","schema":{"type":"string"}},{"name":"page","in":"query","description":"tableau — pagination : `page[number]` (numéro de page, 1 par défaut) et `page[bypage]` (éléments par page, 30 par défaut)","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":4294967294,"fbid":0,"twid":0,"dateEntry":"2026-09-29T20:29:38+02:00","dateUpdate":"2026-10-30T06:42:16+01:00","status":1,"role":["ROLE_USER"],"username":"JohnDoe","email":"","city":"Paris","area":null,"country":null,"timezone":"Pacific/Fakaofo","birthday":"1990-05-17T00:00:00+02:00","origin":3,"bio":"Bio de test","source":"cowroker","relation":"","title":"mr","site":1,"oldIDVDM":null,"oldIDFML":null,"avatar":null,"metrics":null,"signature":null}],"meta":{"page":1,"per_page":2,"page_count":1,"total_count":1},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/keyword":{"get":{"operationId":"api_keyword_empty","tags":["general"],"summary":"Lister les mots-clés de catégorie","description":"Renvoie les mots-clés du site courant utilisés comme catégories, triés par nom. Pour chercher parmi tous les mots-clés par préfixe, utilisez `/keyword/{expr}`.","parameters":[{"name":"expr","in":"query","description":"Non utilisé sur cette route : pour filtrer par préfixe, utilisez `/keyword/{expr}`","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":"1","uid":1,"name":"Amour","label":"Amour","rub":true},{"id":"5","uid":5,"name":"Animaux","label":"Animaux","rub":true}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/keyword/{expr}":{"get":{"operationId":"api_keyword","tags":["general"],"summary":"Chercher des mots-clés par préfixe","description":"Renvoie les mots-clés du site courant dont le nom commence par `{expr}`, triés par nom. Contrairement à `/keyword`, les résultats ne se limitent pas aux catégories.","parameters":[{"name":"expr","in":"path","required":true,"schema":{"type":"string"}},{"name":"expr","in":"query","description":"chaîne, dans le chemin (`{expr}`) — début du nom du mot-clé","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":"1","uid":1,"name":"Amour","label":"Amour","rub":true}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/authenticate":{"post":{"operationId":"api_authenticate","tags":["users"],"summary":"Connecter un membre","description":"En cas de succès, renvoie l’objet membre (200) et le jeton utilisateur dans l’en-tête de réponse `X-VDM-Api-Token` : renvoyez cet en-tête dans vos requêtes suivantes. Renvoie 401 si les identifiants manquent ou sont faux, ou si le compte est banni.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"login":{"type":"string","description":"chaîne, obligatoire — pseudo ou adresse e-mail"},"password":{"type":"string","description":"chaîne, obligatoire — mot de passe du membre, en clair (utilisez toujours HTTPS)"}},"required":["login","password"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"login":{"type":"string","description":"chaîne, obligatoire — pseudo ou adresse e-mail"},"password":{"type":"string","description":"chaîne, obligatoire — mot de passe du membre, en clair (utilisez toujours HTTPS)"}},"required":["login","password"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":4294967294,"fbid":0,"twid":0,"dateEntry":"2026-09-29T20:29:38+02:00","dateUpdate":"2026-10-30T06:42:16+01:00","status":1,"role":["ROLE_USER"],"username":"JohnDoe","email":"name@example.com","city":"Paris","area":null,"country":null,"timezone":"Pacific/Fakaofo","birthday":"1990-05-17T00:00:00+02:00","origin":3,"bio":"Bio de test","source":"cowroker","relation":"","title":"mr","site":1,"oldIDVDM":null,"oldIDFML":null,"avatar":null,"metrics":null,"signature":null},"meta":{},"badge":[],"badge_display":[]}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"100 - You must be authenticated in order to access this function."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"103 - Invalid login credentials."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/refreshtoken":{"post":{"operationId":"api_refreshtoken","tags":["users"],"summary":"Renouveler un jeton utilisateur","description":"Envoyez le jeton expiré dans l’en-tête `X-VDM-Api-Token` avec `secret`. L’ancien jeton est supprimé ; le nouveau est renvoyé dans l’en-tête de réponse `X-VDM-Api-Token`, avec l’objet membre (200). Renvoie 401 en cas d’échec.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"secret":{"type":"string","description":"chaîne, obligatoire — secret du membre : empreinte MD5 de l’id du membre suivi de son pseudo (`md5(id . username)`)"}},"required":["secret"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"secret":{"type":"string","description":"chaîne, obligatoire — secret du membre : empreinte MD5 de l’id du membre suivi de son pseudo (`md5(id . username)`)"}},"required":["secret"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":2321654987,"fbid":0,"twid":0,"dateEntry":"2016-09-16 08:00:18","dateUpdate":"2016-09-16 08:00:18","status":1,"role":{"0":"ROLE_ADMIN"},"username":"admin","email":"fred@free.fr","city":null,"area":null,"country":null,"timezone":"Africa/Harare","birthday":"1997-11-23","origin":1,"bio":"Reiciendis sint sunt eum id tempora rerum occaecati corrupti.","source":"cowroker","relation":"couple","title":"mr","site":1},"meta":{}}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/logout":{"get":{"operationId":"api_logout","tags":["users"],"summary":"Déconnecter le membre","description":"Supprime le jeton utilisateur envoyé dans `X-VDM-Api-Token`. Renvoie `anonymous` en cas de succès, 401 si le jeton est invalide.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":"anonymous","meta":{}}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"100 - You must be authenticated in order to access this function."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/search":{"get":{"operationId":"api_user_search","tags":["users"],"summary":"Vérifier si un pseudo ou un e-mail est disponible","description":"Renvoie `{\"isValid\": true}` si aucun compte n’utilise cette valeur, sinon `isValid: false` avec un message `error`. Pour un e-mail, le domaine est aussi vérifié. Renvoie 400 si `search` ou `value` manque ou est invalide.","parameters":[{"name":"search","in":"query","required":true,"description":"chaîne, obligatoire — champ à vérifier : `username` ou `email`","schema":{"type":"string"}},{"name":"value","in":"query","required":true,"description":"chaîne, obligatoire — pseudo ou adresse e-mail à vérifier","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"isValid":true},"meta":{},"badge":[],"badge_display":[]}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"This username is already associated with an account."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/options":{"get":{"operationId":"api_user_options","tags":["users"],"summary":"Récupérer les options d’un membre","description":"Renvoie les options de notification, de newsletter et de confidentialité du membre, telles que réglées avec `/user/{userid}/moreinfos`. Jeton utilisateur obligatoire.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — id du membre","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"user_id":4294967294,"nl_weekly":true,"nl_monthly":false,"nl_daily":false,"al_comment":true,"al_message":false,"hide_profile":false,"show_activity":false,"show_receipt":false,"optin_vdm":false,"optin_partners":false,"activity_on_timeline":true,"hide_illustrations":false,"user_content_types_filters":[]},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":"Vous devez être authentifié pour accéder à cette fonction.","meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user":{"post":{"operationId":"api_user_create","tags":["users"],"summary":"Créer un compte","description":"Renvoie le nouveau membre (201) et le connecte : le jeton utilisateur est dans l’en-tête de réponse `X-VDM-Api-Token`. Des images d’avatar peuvent être envoyées dans la même requête multipart. Renvoie 400 si le pseudo ou l’e-mail est déjà pris, si l’e-mail est invalide ou si les mots de passe diffèrent.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"chaîne, obligatoire — pseudo"},"email":{"type":"string","description":"chaîne, obligatoire — adresse e-mail"},"password":{"type":"string","description":"chaîne, obligatoire — mot de passe"},"confirm_password":{"type":"string","description":"chaîne, obligatoire — le même mot de passe, une seconde fois"}},"required":["username","email","password","confirm_password"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"chaîne, obligatoire — pseudo"},"email":{"type":"string","description":"chaîne, obligatoire — adresse e-mail"},"password":{"type":"string","description":"chaîne, obligatoire — mot de passe"},"confirm_password":{"type":"string","description":"chaîne, obligatoire — le même mot de passe, une seconde fois"}},"required":["username","email","password","confirm_password"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":50467299,"fbid":0,"twid":0,"dateEntry":{"date":"2016-09-16 10:28:19.000000","timezone_type":3,"timezone":"UTC"},"dateUpdate":null,"status":0,"role":{"0":"ROLE_USER"},"username":"test","email":"test@test.com","city":null,"area":null,"country":null,"timezone":null,"birthday":null,"origin":"api","bio":null,"source":"site","relation":null,"title":"mr","site":3},"meta":{}}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"This username is already associated with an account."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/avatar":{"post":{"operationId":"api_user_update_avatar","tags":["users"],"summary":"Envoyer les avatars d’un membre","description":"Envoyez les images en fichiers multipart. Taille maximale : 25 Mo par fichier. Renvoie les avatars (202). Uniquement pour votre propre compte (un admin peut agir sur tout compte), 403 sinon.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"img_1":{"type":"string","description":"fichier, obligatoire — premier avatar (photo de profil principale)"},"img_2":{"type":"string","description":"fichier, facultatif — deuxième avatar"},"img_3":{"type":"string","description":"fichier, facultatif — troisième avatar"}},"required":["userid","img_1"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"img_1":{"type":"string","description":"fichier, obligatoire — premier avatar (photo de profil principale)"},"img_2":{"type":"string","description":"fichier, facultatif — deuxième avatar"},"img_3":{"type":"string","description":"fichier, facultatif — troisième avatar"}},"required":["userid","img_1"]}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"img_1":{"url":"/img/4a081d3b5c2a14e9f38471d80202df34.jpeg/avatar_small/img_users","id":5,"name":"4a081d3b5c2a14e9f38471d80202df34.jpeg"},"img_2":{"url":"/images/default-avatar.jpg","id":""},"img_3":{"url":"/images/default-avatar.jpg","id":""}},"meta":{}}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"400 - The file is too large. Allowed maximum size is 1 MB."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"404 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/moreinfos":{"put":{"operationId":"api_user_update_moreinfos","tags":["users"],"summary":"Modifier les options de notification et de confidentialité d’un membre","description":"Seuls les champs envoyés sont modifiés. Chaque option vaut `1` (activée) ou `0` (désactivée). Renvoie les options mises à jour (202). Uniquement pour votre propre compte (un admin peut agir sur tout compte), 403 sinon. Relisez-les avec `/user/{userid}/options`.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"optin_vdm":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — recevoir les actualités du site"},"optin_partners":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — recevoir les offres promotionnelles des partenaires"},"nl_weekly":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — s’abonner à la newsletter hebdomadaire"},"al_comment":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — être prévenu quand un commentaire est publié sur une VDM suivie"},"al_message":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — être prévenu des nouveaux messages privés"},"nl_daily":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — s’abonner à la newsletter quotidienne"},"hide_profile":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — masquer mon profil"},"show_activity":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — afficher mon activité"},"activity_on_timeline":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — publier mon activité sur mon fil"},"show_receipt":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — envoyer des accusés de lecture"},"user_content_types_filters":{"type":"string","description":"tableau d’entiers, facultatif — ids des types de contenu à filtrer (voir `/article/type/list`) ; une valeur vide laisse le filtre actuel inchangé"}},"required":["userid"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"optin_vdm":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — recevoir les actualités du site"},"optin_partners":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — recevoir les offres promotionnelles des partenaires"},"nl_weekly":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — s’abonner à la newsletter hebdomadaire"},"al_comment":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — être prévenu quand un commentaire est publié sur une VDM suivie"},"al_message":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — être prévenu des nouveaux messages privés"},"nl_daily":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — s’abonner à la newsletter quotidienne"},"hide_profile":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — masquer mon profil"},"show_activity":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — afficher mon activité"},"activity_on_timeline":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — publier mon activité sur mon fil"},"show_receipt":{"type":"integer","enum":[0,1],"description":"`1` ou `0`, facultatif — envoyer des accusés de lecture"},"user_content_types_filters":{"type":"string","description":"tableau d’entiers, facultatif — ids des types de contenu à filtrer (voir `/article/type/list`) ; une valeur vide laisse le filtre actuel inchangé"}},"required":["userid"]}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"user_id":4294967294,"nl_weekly":true,"nl_monthly":false,"nl_daily":false,"al_comment":true,"al_message":false,"hide_profile":false,"show_activity":false,"show_receipt":false,"optin_vdm":false,"optin_partners":false,"activity_on_timeline":true,"hide_illustrations":false,"user_content_types_filters":[]},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":"Vous devez être authentifié pour accéder à cette fonction.","meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"404 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}":{"delete":{"operationId":"api_user_delete","tags":["users"],"summary":"Demander la suppression d’un compte","description":"Ne supprime pas le compte tout de suite : envoie au membre un e-mail avec un lien pour confirmer la suppression. Renvoie 204. Uniquement pour votre propre compte (un admin peut agir sur tout compte), 403 sinon.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — votre id de membre","schema":{"type":"string"}}],"responses":{"204":{"description":"Succès","content":{"application/json":{"example":{"data":{"response":"The procedure was performed"},"meta":{}}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"404 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/like":{"post":{"operationId":"api_user_like","tags":["users"],"summary":"Liker un membre","description":"Jeton utilisateur obligatoire : l’auteur du like est toujours le membre authentifié, qui ne peut pas se liker lui-même (401). Renvoie le nouveau nombre de likes du membre, `number_of_likes` (202), ou 208 si vous l’aviez déjà liké. Le membre liké est notifié.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"Ignoré : l’auteur du like est toujours le membre authentifié"},"user_liked":{"type":"string","description":"entier, obligatoire — id du membre à liker"}},"required":["userid","user_liked"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"Ignoré : l’auteur du like est toujours le membre authentifié"},"user_liked":{"type":"string","description":"entier, obligatoire — id du membre à liker"}},"required":["userid","user_liked"]}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":"{\n  \"data\": {\n    \"number_of_likes\": xx\n  },\n  \"meta\": {}\n}"}}},"208":{"description":"Erreur","content":{"application/json":{"example":{"error":"208 - You have already liked this user."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/connect/facebook":{"post":{"operationId":"api_user_facebook_connect","tags":["users"],"summary":"Se connecter avec Facebook (désactivé)","description":"Cet endpoint est désactivé : il renvoie toujours 400. Utilisez `/user/authenticate`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"chaîne — id Facebook de l’utilisateur (ignoré : endpoint désactivé)"},"name":{"type":"string","description":"chaîne — nom (ignoré : endpoint désactivé)"},"email":{"type":"string","description":"chaîne — adresse e-mail (ignorée : endpoint désactivé)"},"gender":{"type":"string","description":"chaîne — genre (ignoré : endpoint désactivé)"},"birthday":{"type":"string","description":"chaîne — date de naissance (ignorée : endpoint désactivé)"},"location":{"type":"string","description":"chaîne — localisation (ignorée : endpoint désactivé)"},"picture":{"type":"string","description":"chaîne — URL de la photo (ignorée : endpoint désactivé)"}},"required":["id","name","email"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"chaîne — id Facebook de l’utilisateur (ignoré : endpoint désactivé)"},"name":{"type":"string","description":"chaîne — nom (ignoré : endpoint désactivé)"},"email":{"type":"string","description":"chaîne — adresse e-mail (ignorée : endpoint désactivé)"},"gender":{"type":"string","description":"chaîne — genre (ignoré : endpoint désactivé)"},"birthday":{"type":"string","description":"chaîne — date de naissance (ignorée : endpoint désactivé)"},"location":{"type":"string","description":"chaîne — localisation (ignorée : endpoint désactivé)"},"picture":{"type":"string","description":"chaîne — URL de la photo (ignorée : endpoint désactivé)"}},"required":["id","name","email"]}}}},"responses":{"200":{"description":"Succès"},"400":{"description":"Succès","content":{"application/json":{"example":{"data":"Missing datas for facebook connect","meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/connect/twitter":{"post":{"operationId":"api_user_twitter_connect","tags":["users"],"summary":"Se connecter avec Twitter (désactivé)","description":"Cet endpoint est désactivé : il renvoie toujours 400. Utilisez `/user/authenticate`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"chaîne — id Twitter de l’utilisateur (ignoré : endpoint désactivé)"},"name":{"type":"string","description":"chaîne — nom (ignoré : endpoint désactivé)"},"email":{"type":"string","description":"chaîne — adresse e-mail (ignorée : endpoint désactivé)"},"description":{"type":"string","description":"chaîne — description du profil (ignorée : endpoint désactivé)"},"profile_image_url":{"type":"string","description":"chaîne — URL de la photo (ignorée : endpoint désactivé)"}},"required":["id","name","email"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"chaîne — id Twitter de l’utilisateur (ignoré : endpoint désactivé)"},"name":{"type":"string","description":"chaîne — nom (ignoré : endpoint désactivé)"},"email":{"type":"string","description":"chaîne — adresse e-mail (ignorée : endpoint désactivé)"},"description":{"type":"string","description":"chaîne — description du profil (ignorée : endpoint désactivé)"},"profile_image_url":{"type":"string","description":"chaîne — URL de la photo (ignorée : endpoint désactivé)"}},"required":["id","name","email"]}}}},"responses":{"200":{"description":"Succès"},"400":{"description":"Succès","content":{"application/json":{"example":{"data":"Missing datas for twitter connect","meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/resetpassword":{"post":{"operationId":"api_user_reset_password","tags":["users"],"summary":"Envoyer un lien de réinitialisation du mot de passe","description":"Si un compte utilise cet e-mail, lui envoie un lien pour choisir un nouveau mot de passe ; le mot de passe actuel reste valable d’ici là. Renvoie 200 pour tout e-mail valide, qu’un compte l’utilise ou non, et 400 si l’e-mail est invalide.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"chaîne, obligatoire — adresse e-mail du compte"}},"required":["email"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"chaîne, obligatoire — adresse e-mail du compte"}},"required":["email"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":"User's password has been reset","meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"404 - This user not found."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/edit/password/{userid}":{"put":{"operationId":"api_user_edit_password","tags":["users"],"summary":"Changer le mot de passe d’un membre","description":"Renvoie 202 en cas de succès, 400 si `confirm_password` manque ou ne correspond pas, 403 si `current_password` est absent ou faux. Les autres sessions du membre (ses autres jetons) sont déconnectées ; le jeton de la requête reste valable. Uniquement pour votre propre compte (un admin peut agir sur tout compte sans `current_password`), 403 sinon.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"current_password":{"type":"string","description":"chaîne, obligatoire — mot de passe actuel du membre"},"password":{"type":"string","description":"chaîne, obligatoire — nouveau mot de passe"},"confirm_password":{"type":"string","description":"chaîne, obligatoire — le nouveau mot de passe, une seconde fois"}},"required":["userid","current_password","password","confirm_password"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"current_password":{"type":"string","description":"chaîne, obligatoire — mot de passe actuel du membre"},"password":{"type":"string","description":"chaîne, obligatoire — nouveau mot de passe"},"confirm_password":{"type":"string","description":"chaîne, obligatoire — le nouveau mot de passe, une seconde fois"}},"required":["userid","current_password","password","confirm_password"]}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":"User's password has been updated","meta":{}}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"16 - Field confirm_password is missing."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/edit/email/{userid}":{"put":{"operationId":"api_user_edit_email","tags":["users"],"summary":"Changer l’adresse e-mail d’un membre","description":"Le compte repasse en attente jusqu’à ce que le membre clique sur le lien de validation envoyé à la nouvelle adresse. Renvoie 202 en cas de succès, 400 si l’e-mail est déjà pris ou invalide, 403 si `current_password` est absent ou faux. Uniquement pour votre propre compte (un admin peut agir sur tout compte sans `current_password`), 403 sinon.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"current_password":{"type":"string","description":"chaîne, obligatoire — mot de passe actuel du membre"},"email":{"type":"string","description":"chaîne, obligatoire — nouvelle adresse e-mail"}},"required":["userid","current_password","email"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"current_password":{"type":"string","description":"chaîne, obligatoire — mot de passe actuel du membre"},"email":{"type":"string","description":"chaîne, obligatoire — nouvelle adresse e-mail"}},"required":["userid","current_password","email"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":"User's email has been updated","meta":{}}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"12 - This email is already associated with an account."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/uniqid":{"get":{"operationId":"api_user_generate_uniqid","tags":["users"],"summary":"Générer un identifiant de visiteur","description":"Renvoie `{\"uniqid\": …}`, un entier aléatoire qui identifie un appareil anonyme. Envoyez-le dans l’en-tête `X-VDM-Uniqid` pour que les votes, smileys et modérations soient enregistrés sans compte.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"uniqid":1139849784},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/profile":{"put":{"operationId":"api_user_update_profile","tags":["users"],"summary":"Modifier le profil d’un membre","description":"Seuls les champs envoyés sont modifiés : `title`, `birthday`, `city`, `relation`, `bio`, ainsi que `area`, `country`, `countrycode`, `timezone` et `source` ; les autres champs sont ignorés (l’e-mail et le mot de passe ont leurs propres endpoints). Renvoie le membre mis à jour (202), ou 400 si la bio est trop longue. Uniquement pour votre propre compte (un admin peut agir sur tout compte), 403 sinon.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"title":{"type":"string","description":"chaîne, facultative — civilité : `mr`, `mrs` ou `miss`"},"birthday":{"type":"string","format":"date","description":"date, facultative — date de naissance, `AAAA-MM-JJ` ou ISO 8601"},"city":{"type":"string","description":"chaîne, facultative — ville"},"relation":{"type":"string","description":"chaîne, facultative — situation amoureuse : `single`, `couple` ou `complicated`"},"bio":{"type":"string","description":"chaîne, facultative — biographie, 2 000 caractères maximum"}},"required":["userid"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"title":{"type":"string","description":"chaîne, facultative — civilité : `mr`, `mrs` ou `miss`"},"birthday":{"type":"string","format":"date","description":"date, facultative — date de naissance, `AAAA-MM-JJ` ou ISO 8601"},"city":{"type":"string","description":"chaîne, facultative — ville"},"relation":{"type":"string","description":"chaîne, facultative — situation amoureuse : `single`, `couple` ou `complicated`"},"bio":{"type":"string","description":"chaîne, facultative — biographie, 2 000 caractères maximum"}},"required":["userid"]}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":4294967294,"fbid":0,"twid":0,"dateEntry":"2026-09-29T20:29:38+02:00","dateUpdate":"2026-10-30T06:42:16+01:00","status":1,"role":["ROLE_USER"],"username":"JohnDoe","email":"name@example.com","city":"Paris","area":null,"country":null,"timezone":"Pacific/Fakaofo","birthday":"1990-05-17T00:00:00+02:00","origin":3,"bio":"Bio de test","source":"cowroker","relation":"","title":"mr","site":1,"oldIDVDM":null,"oldIDFML":null,"avatar":null,"metrics":null,"signature":null},"meta":{},"badge":[],"badge_display":[]}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"14 - About me content can not exceed more 300 characters long."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":"Vous devez être authentifié pour accéder à cette fonction.","meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]},"get":{"operationId":"api_user_profile","tags":["users"],"summary":"Récupérer le profil d’un membre, en étant connecté","description":"Jeton utilisateur obligatoire. Comme `/user/{userid}/member`, avec en plus le nombre de visites, de likes et d’amis ; la visite est comptée pour le membre connecté. 404 si le membre n’existe pas.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, dans le chemin — id du membre","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"user":{"id":4294967294,"fbid":0,"twid":0,"dateEntry":"2026-09-29T20:29:38+02:00","dateUpdate":"2026-10-30T06:42:16+01:00","status":1,"role":["ROLE_USER"],"username":"JohnDoe","email":"name@example.com","city":"Paris","area":null,"country":null,"timezone":"Pacific/Fakaofo","birthday":"1990-05-17T00:00:00+02:00","origin":3,"bio":"Bio de test","source":"cowroker","relation":"","title":"mr","site":1,"oldIDVDM":null,"oldIDFML":null,"avatar":null,"metrics":null,"signature":null},"avatar_1":null,"avatar_2":{"url":"https://www.viedemerde.fr/img/4c312a6bec147abb7872d50d2f157ed1.jpg/avatar_small/img_users","id":30,"name":"4c312a6bec147abb7872d50d2f157ed1.jpg"},"avatar_3":null,"profile_visibility":false,"number_of_visits":1005,"number_of_likes":2,"number_of_friends":0,"number_of_followers":0,"number_of_comment":36,"number_of_favorite":8,"number_of_article":1,"number_of_badge":24,"metrics":{"isFollowed":false,"isBlocked":false,"isLike":false}},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":"Vous devez être authentifié pour accéder à cette fonction.","meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"404 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/member":{"get":{"operationId":"api_user_member","tags":["users"],"summary":"Récupérer la page publique d’un membre","description":"Renvoie le membre (champs publics, sauf pour vous-même et les admins), ses trois avatars, la visibilité de son profil et ses statistiques. Avec `X-VDM-Uniqid`, la visite est comptée. 404 si le membre n’existe pas.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, dans le chemin — id du membre","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"user":{"id":4294967294,"dateEntry":"2026-09-29T20:29:38+02:00","status":1,"username":"JohnDoe","city":"Paris","country":null,"bio":"Bio de test","relation":"","title":"mr","site":1,"avatar":null,"metrics":null,"signature":null},"avatar_1":null,"avatar_2":{"url":"https://www.viedemerde.fr/img/4c312a6bec147abb7872d50d2f157ed1.jpg/avatar_small/img_users","id":30,"name":"4c312a6bec147abb7872d50d2f157ed1.jpg"},"avatar_3":null,"profile_visibility":false,"number_of_visits":1005,"number_of_likes":2,"number_of_friends":0,"number_of_followers":0,"number_of_comment":36,"number_of_favorite":8,"number_of_article":1,"number_of_badge":24},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"404 - This user not found."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/visits":{"get":{"operationId":"api_user_visits","tags":["users"],"summary":"Lister les visiteurs du profil d’un membre","description":"Avec pagination : `meta` donne `page`, `per_page`, `page_count` et `total_count`. Visites les plus récentes d’abord par défaut.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — id du membre","schema":{"type":"string"}},{"name":"page","in":"query","description":"tableau — pagination : `page[number]` (numéro de page, 1 par défaut) et `page[bypage]` (éléments par page, 30 par défaut)","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true},{"name":"orderby","in":"query","description":"tableau, `orderby[date]=DESC` par défaut — ordre de tri, sous la forme `orderby[champ]=ASC|DESC`","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":4294967295,"username":"admin","birthday":"1944-10-30T00:00:00+0100","relation":"couple","city":"Lille","country":null,"avatar":null,"title":null,"dateofvisit":"1791454075","metrics":{"isFollowed":false,"isBlocked":false,"isLike":false}},{"id":3216549910,"username":"VDMbot","birthday":"2001-12-06T00:00:00+0100","relation":"single","city":"Lille","country":null,"avatar":null,"title":"mrs","dateofvisit":"-1425592455","metrics":{"isFollowed":false,"isBlocked":false,"isLike":false}}],"meta":{"page":1,"per_page":30,"page_count":1,"total_count":6},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/likes":{"get":{"operationId":"api_user_likes","tags":["users"],"summary":"Lister les membres qui ont liké un membre","description":"Avec pagination : `meta` donne `page`, `per_page`, `page_count` et `total_count`. Likes les plus récents d’abord par défaut.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — id du membre","schema":{"type":"string"}},{"name":"page","in":"query","description":"tableau — pagination : `page[number]` (numéro de page, 1 par défaut) et `page[bypage]` (éléments par page, 30 par défaut)","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true},{"name":"orderby","in":"query","description":"tableau, `orderby[date]=DESC` par défaut — ordre de tri, sous la forme `orderby[champ]=ASC|DESC`","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":4294967295,"username":"admin","birthday":"1944-10-30T00:00:00+0100","relation":"couple","city":"Lille","country":null,"avatar":null,"title":null,"dateoflike":"1793346960"}],"meta":{"page":1,"per_page":30,"page_count":1,"total_count":1},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/avatar/{userid}/{imageid}":{"delete":{"operationId":"api_user_delete_avatar","tags":["users"],"summary":"Supprimer un des avatars d’un membre","description":"Renvoie 200 en cas de succès, 404 si le membre ou l’image n’existe pas. Uniquement pour votre propre compte (un admin peut agir sur tout compte), 403 sinon.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"imageid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — votre id de membre","schema":{"type":"string"}},{"name":"imageid","in":"query","required":true,"description":"entier, obligatoire, dans le chemin (`{imageid}`) — id de l’image à supprimer","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":"{\n  \"data\": \"User's avatar has been deleted\",\n  \"meta\": {}\n}\n\nWith attribute /all\n\n{\n  \"data\": \"All user's avatar has been deleted\",\n  \"meta\": {}\n}"}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/avatar/{userid}/all":{"delete":{"operationId":"api_user_delete_all_avatar","tags":["users"],"summary":"Supprimer tous les avatars d’un membre","description":"Renvoie 200 en cas de succès. Uniquement pour votre propre compte (un admin peut agir sur tout compte), 403 sinon.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — votre id de membre","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":"All user's avatar has been deleted","meta":{}}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/avatar/{userid}":{"patch":{"operationId":"api_user_patch_avatar","tags":["users"],"summary":"Réordonner les avatars d’un membre","description":"Envoyez les ids des images dans l’ordre d’affichage voulu. Renvoie 200. Uniquement pour votre propre compte (un admin peut agir sur tout compte), 403 sinon.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"img_1":{"type":"string","description":"entier, obligatoire — id de l’image à afficher en premier"},"img_2":{"type":"string","description":"entier, obligatoire — id de l’image à afficher en deuxième"},"img_3":{"type":"string","description":"entier, obligatoire — id de l’image à afficher en troisième"}},"required":["userid","img_1","img_2","img_3"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"userid":{"type":"string","description":"entier, obligatoire — votre id de membre"},"img_1":{"type":"string","description":"entier, obligatoire — id de l’image à afficher en premier"},"img_2":{"type":"string","description":"entier, obligatoire — id de l’image à afficher en deuxième"},"img_3":{"type":"string","description":"entier, obligatoire — id de l’image à afficher en troisième"}},"required":["userid","img_1","img_2","img_3"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":"User's avatar have been updated","meta":{}}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/badges":{"get":{"operationId":"api_user_get_badges","tags":["users"],"summary":"Lister les badges d’un membre","description":"Jeton utilisateur obligatoire. Renvoie 404 si le membre n’existe pas.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — id du membre","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"user":4294967294,"id":1,"status":1,"progression":5,"data":"","stamp":"2026-09-30T08:16:00+02:00","site":null,"name":"Débutant","description":"Vous avez parcouru 5 pages du site. C'est un début.","hidden":"0","goal":5,"limited":"0","category":1,"total":7698968,"illustration":"lI6nHr5hWXlu0.gif"},{"user":4294967294,"id":26,"status":1,"progression":1,"data":"","stamp":"2026-10-14T14:13:55+02:00","site":null,"name":"Dura lex sed lex","description":"Lire la charte, c'est bien. Ce badge est sponsorisé par Alan, notre modérateur.","hidden":"0","goal":1,"limited":"0","category":1,"total":46695,"illustration":"26.gif"}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":["Vous devez être authentifié pour accéder à cette fonction."],"meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/articles":{"get":{"operationId":"api_user_get_articles","tags":["users"],"summary":"Lister les VDM d’un membre","description":"Jeton utilisateur obligatoire. Pour votre propre compte, vos VDM dans tous les statuts sauf supprimé (y compris en attente et refusées) ; pour un autre membre, ses VDM publiées seulement. Avec mots-clés, statistiques, images, paragraphes et vidéos. Sans pagination.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — id du membre","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":518671,"status":11,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":null,"content":"Today, I tested the API for an hour before noticing I had swapped my key and my token. FML","content_hidden":"Today, I tested the API for an hour before noticing I had swapped my key and my token. FML","created":"2026-10-30T08:54:24+01:00","updated":"2026-10-30T08:54:24+01:00","published":"2026-10-30T08:54:24+01:00","user":4294967294,"author":"JohnDoe","gender":null,"layout":0,"flag":0,"origin":"api","apikey":"{{apikey}}","vote":1,"site":1,"siteorig":null,"slug":"today-i-tested-the-api-for-an-hour-before-noticing-i-had-swapped-my-key-and-my-token-fml","bitly":null,"metrics":{"article":518671,"comment":0,"favorite":0,"reports":1,"mod_positive":0,"mod_negative":0,"votes_up":0,"votes_down":0,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":false,"smiley":null,"votes":null},"keywords":[],"images":[],"videos":[],"openview":0,"url":null,"suggested":null,"paragraphs":[]},{"id":518670,"status":11,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":null,"content":"Today, I tested the API for an hour before noticing I had swapped my key and my token. FML","content_hidden":"Today, I tested the API for an hour before noticing I had swapped my key and my token. FML","created":"2026-10-30T08:53:13+01:00","updated":"2026-10-30T08:53:13+01:00","published":"2026-10-30T08:53:13+01:00","user":4294967294,"author":"JohnDoe","gender":null,"layout":0,"flag":0,"origin":"api","apikey":"{{apikey}}","vote":1,"site":1,"siteorig":null,"slug":"today-i-tested-the-api-for-an-hour-before-noticing-i-had-swapped-my-key-and-my-token-fml","bitly":null,"metrics":{"article":518670,"comment":0,"favorite":0,"reports":1,"mod_positive":0,"mod_negative":0,"votes_up":0,"votes_down":0,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":false,"smiley":null,"votes":null},"keywords":[],"images":[],"videos":[],"openview":0,"url":null,"suggested":null,"paragraphs":[]}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":["Vous devez être authentifié pour accéder à cette fonction."],"meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/favorites":{"get":{"operationId":"api_user_get_favorites","tags":["users"],"summary":"Lister les VDM favorites d’un membre","description":"Jeton utilisateur obligatoire. Avec pagination (`meta`). Chaque VDM inclut vos propres votes, smileys et favoris.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — id du membre","schema":{"type":"string"}},{"name":"page","in":"query","description":"tableau — pagination : `page[number]` (numéro de page, 1 par défaut) et `page[bypage]` (éléments par page, 30 par défaut)","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":518664,"status":4,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":"Amusez-vous bien…","content":"Aujourd'hui, retour de soirée. Sur la route, ma femme compte combien de lapins nous croisons sur le côté de la route, et me dit que ce serait bête d'en écraser un. Un lapin ? Je n'en ai pas écrasé. Mais un sanglier… VDM","content_hidden":"Aujourd'hui, retour de soirée. Sur la route, ma femme compte combien de lapins nous croisons sur le côté de la route, et me dit que ce serait bête d'en écraser un. Un lapin ? Je n'en ai pas écrasé. Mais un sanglier… VDM","created":"2026-10-06T21:58:24+02:00","updated":"2026-10-21T11:09:45+02:00","published":"2026-10-18T07:55:00+02:00","user":1,"author":"Laure","gender":2,"layout":0,"flag":0,"origin":"api","apikey":"b4e042287442ad81","vote":1,"site":1,"siteorig":null,"slug":"amusez-vous-bien","bitly":null,"metrics":{"article":518664,"comment":5,"favorite":1,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":4,"votes_down":13,"smiley_amusing":4,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":true,"smiley":1,"votes":null},"keywords":[],"images":[{"url":"https://localhost:8100/img/62da819fa43dd02828de70822f7b2e70.png/medium/","usage":8,"name":"62da819fa43dd02828de70822f7b2e70.png","copyright":null,"legend":null,"width":1200,"height":628},{"url":"https://localhost:8100/img/1cbf05493820b33ab4cece8a1e7d87c0.png/medium/","usage":9,"name":"1cbf05493820b33ab4cece8a1e7d87c0.png","copyright":null,"legend":null,"width":1200,"height":628}],"videos":[],"openview":0,"url":null,"suggested":null},{"id":9,"status":4,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":"","content":"Aujourd'hui, comme tous les 10 août en trois ans de relation, ma copine est triste et pleure beaucoup sans que je puisse la consoler. Supposant que c'était la date de décès d'un proche, je n'avais jamais osé demander la raison. Aujourd'hui, j'ai appris que c'était la date de r…","content_hidden":"Aujourd'hui, comme tous les 10 août en trois ans de relation, ma copine est triste et pleure beaucoup sans que je puisse la consoler. Supposant que c'était la date de décès d'un proche, je n'avais jamais osé demander la raison. Aujourd'hui, j'ai appris que c'était la date de r…","created":"2026-09-29T20:29:41+02:00","updated":"2026-10-04T10:19:37+02:00","published":"2026-10-04T08:19:37+02:00","user":2321654987,"author":null,"gender":null,"layout":0,"flag":0,"origin":null,"apikey":null,"vote":2,"site":1,"siteorig":null,"slug":"aujourd-hui-comme-tous-les-10-aout-en-trois-ans-de-relation-ma-copine-est-triste-et-pleure-beauco","bitly":null,"metrics":{"article":9,"comment":0,"favorite":0,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":1,"votes_down":10,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":true,"smiley":null,"votes":null},"keywords":[],"images":[],"videos":[],"openview":0,"url":null,"suggested":null}],"meta":{"page":1,"per_page":30,"page_count":1,"total_count":7},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":["Vous devez être authentifié pour accéder à cette fonction."],"meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/user/{userid}/comments":{"get":{"operationId":"api_user_get_comments","tags":["users"],"summary":"Lister les commentaires d’un membre","description":"Jeton utilisateur obligatoire. Renvoie les commentaires de premier niveau du membre (pas ses réponses à d’autres commentaires), chacun avec ses réponses. Sans pagination.","parameters":[{"name":"userid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"userid","in":"query","required":true,"description":"entier, obligatoire — id du membre","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":1,"date":"2026-09-30T05:10:06+02:00","status":0,"parent":0,"content":"Commentaire de test normal","article":5,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":3,"thumbdown":0,"userthumbed":0,"report":0,"isModerator":false,"replies":null},{"id":3,"date":"2026-09-30T06:40:06+02:00","status":4,"parent":0,"content":"Commentaire supprimé","article":5,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":0,"thumbdown":4,"userthumbed":0,"report":2,"isModerator":false,"replies":null}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":["Vous devez être authentifié pour accéder à cette fonction."],"meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"10 - This user not found."}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/status/list":{"get":{"operationId":"api_article_status_list","tags":["articles"],"summary":"Lister les statuts de VDM","description":"Renvoie des paires `uid`/`label` : 0 new (en attente de modération par la communauté), 1 rejected, 2 promoted, 3 refused, 4 validated (publiée), 5 private, 6 autopilot, 7 deleted, 8 scheduled, 9 tocheck, 10 BestOfPire, 11 Check Edito (en attente de relecture par la rédaction), 12 republished.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"uid":11,"label":"Check Edito"},{"uid":0,"label":"new"}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/type/list":{"get":{"operationId":"api_article_type_list","tags":["articles"],"summary":"Lister les types de VDM","description":"Renvoie des paires `uid`/`label`, par exemple 1 classic, 3 photo, 6 confession, 9 news, 10 video, 16 contest.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"uid":1,"label":"classic"},{"uid":3,"label":"photo"}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":"{\n  \"error\": \"102 - Invalid API key.\"\n}\n\nERROR CODE: 500 (INTERNAL SERVER ERROR)\nContent:\n{\n  \"error\": \"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known\"\n}"}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/gender/list":{"get":{"operationId":"api_article_sexe_list","tags":["articles"],"summary":"Lister les genres d’auteur","description":"Renvoie des paires `uid`/`label` : 1 man, 2 woman, 3 Other, 4 Enby, 5 TransFem, 6 TransMasc. Utilisez l’`uid` comme `gender` pour soumettre une VDM.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"uid":1,"label":"man"},{"uid":2,"label":"woman"}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/votetype/list":{"get":{"operationId":"api_article_votetype_list","tags":["articles"],"summary":"Lister les types de vote","description":"Renvoie des paires `uid`/`label` (libellés traduits) pour les boutons de vote. Utilisez l’`uid` avec `/article/{article}/vote/{votetype}`.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"uid":1,"label":"Tu l'as bien mérité"},{"uid":2,"label":"Ça aurait pu m'arriver"}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":"{\n  \"error\": \"102 - Invalid API key.\"\n}\n\nERROR CODE: 500 (INTERNAL SERVER ERROR)\nContent:\n{\n  \"error\": \"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known\"\n}"}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/category/list":{"get":{"operationId":"api_article_category_list","tags":["articles"],"summary":"Lister les catégories","description":"Renvoie les catégories du site courant, triées par nom, avec `uid`, `label` et `rub` (toujours vrai). Utilisez un `uid` comme `keyword[]` dans `/article/list`.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"uid":1,"label":"Amour","rub":true},{"uid":5,"label":"Animaux","rub":true}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/smiley/list":{"get":{"operationId":"api_article_smiley_list","tags":["articles"],"summary":"Lister les smileys","description":"Renvoie des paires `uid`/`label` : 1 amusing, 2 funny, 3 weird, 4 hilarious. Utilisez l’`uid` avec `/article/{article}/smile/{smiley}`.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"uid":1,"label":"amusing"},{"uid":2,"label":"funny"}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article":{"post":{"operationId":"api_article_create","tags":["articles"],"summary":"Soumettre une VDM","description":"La VDM est créée avec le statut 11 (Check Edito) : la rédaction la relit avant qu’elle passe en modération ou soit publiée. Elle est rattachée au membre authentifié, s’il y en a un. Le contenu doit faire entre 20 et 320 caractères ; les guillemets droits qui l’entourent sont retirés. Renvoie la VDM (201), ou 400 si le contenu est trop court ou trop long, ou si une participation au concours n’a pas d’e-mail. Les autres champs envoyés sont ignorés.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"chaîne, obligatoire en pratique — texte de la VDM, de 20 à 320 caractères"},"author":{"type":"string","description":"chaîne, facultative — nom d’auteur affiché avec la VDM"},"email":{"type":"string","description":"chaîne, facultative — adresse e-mail de l’auteur ; obligatoire pour une participation au concours"},"type":{"type":"string","description":"entier, 1 (classic) par défaut — type de VDM : 1 (classic), 3 (photo), 6 (confession), 15 (medics) ou 16 (contest) ; toute autre valeur donne 1"},"spicy":{"type":"string","description":"booléen, false par défaut — la VDM est épicée (contenu adulte)"},"contest":{"type":"string","description":"booléen, false par défaut — participation au concours : passe le type à 16 (contest) et rend `email` obligatoire"},"optin":{"type":"string","description":"booléen, false par défaut — indicateur d’opt-in"},"title":{"type":"string","description":"chaîne, facultative — titre"},"gender":{"type":"string","description":"entier, facultatif — genre de l’auteur, voir `/article/gender/list`"}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"chaîne, obligatoire en pratique — texte de la VDM, de 20 à 320 caractères"},"author":{"type":"string","description":"chaîne, facultative — nom d’auteur affiché avec la VDM"},"email":{"type":"string","description":"chaîne, facultative — adresse e-mail de l’auteur ; obligatoire pour une participation au concours"},"type":{"type":"string","description":"entier, 1 (classic) par défaut — type de VDM : 1 (classic), 3 (photo), 6 (confession), 15 (medics) ou 16 (contest) ; toute autre valeur donne 1"},"spicy":{"type":"string","description":"booléen, false par défaut — la VDM est épicée (contenu adulte)"},"contest":{"type":"string","description":"booléen, false par défaut — participation au concours : passe le type à 16 (contest) et rend `email` obligatoire"},"optin":{"type":"string","description":"booléen, false par défaut — indicateur d’opt-in"},"title":{"type":"string","description":"chaîne, facultative — titre"},"gender":{"type":"string","description":"entier, facultatif — genre de l’auteur, voir `/article/gender/list`"}}}}}},"responses":{"201":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":518672,"status":11,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":null,"content":"Today, I tested the API for an hour before noticing I had swapped my key and my token. FML","content_hidden":null,"created":"2026-10-30T08:56:00+01:00","updated":"2026-10-30T08:56:00+01:00","published":"2026-10-30T08:56:00+01:00","user":4294967294,"author":"JohnDoe","gender":null,"layout":0,"flag":0,"origin":"api","apikey":"{{apikey}}","vote":1,"site":1,"siteorig":null,"slug":"today-i-tested-the-api-for-an-hour-before-noticing-i-had-swapped-my-key-and-my-token-fml","bitly":null,"metrics":{"article":0,"comment":0,"favorite":0,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":0,"votes_down":0,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":false,"smiley":null,"votes":null},"keywords":[],"images":[],"videos":[],"openview":0,"url":null,"suggested":null},"meta":{},"badge":[],"badge_display":[]}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"No article content provided."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"error":"Article not found."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/{article}":{"get":{"operationId":"api_article","tags":["articles"],"summary":"Récupérer une VDM par son id","description":"Inclut mots-clés, statistiques, images, vidéos, paragraphes et jusqu’à 10 VDM suggérées, ainsi que vos votes, smileys et favoris si un jeton utilisateur ou `X-VDM-Uniqid` est envoyé. Les paragraphes sont dans un tableau `paragraphs` d’objets avec un `type` et un `content` : `html` (texte HTML) ou `article` (une VDM intégrée, au même format que dans `/article/list`). Les VDM promues et refusées sont renvoyées avec le type 12 (almost). Renvoie 404 si la VDM n’existe pas. Les VDM privées, supprimées ou programmées répondent aussi 404, sauf pour leur auteur et l’équipe du site.","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"integer"}},{"name":"article","in":"query","description":"entier, dans le chemin — id de la VDM","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":518664,"status":4,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":"Amusez-vous bien…","content":"","content_hidden":"Aujourd'hui, retour de soirée. Sur la route, ma femme compte combien de lapins nous croisons sur le côté de la route, et me dit que ce serait bête d'en écraser un. Un lapin ? Je n'en ai pas écrasé. Mais un sanglier… VDM","created":"2026-10-06T21:58:24+02:00","updated":"2026-10-21T11:09:45+02:00","published":"2026-10-18T07:55:00+02:00","user":1,"author":"Laure","gender":2,"layout":0,"flag":0,"origin":"api","apikey":"b4e042287442ad81","vote":1,"site":1,"siteorig":null,"slug":"amusez-vous-bien","bitly":null,"metrics":{"article":518664,"comment":5,"favorite":1,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":4,"votes_down":13,"smiley_amusing":4,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":false,"smiley":null,"votes":null},"keywords":[],"images":[{"url":"https://localhost:8100/img/62da819fa43dd02828de70822f7b2e70.png/medium/","usage":8,"name":"62da819fa43dd02828de70822f7b2e70.png","copyright":null,"legend":null,"width":1200,"height":628},{"url":"https://localhost:8100/img/1cbf05493820b33ab4cece8a1e7d87c0.png/medium/","usage":9,"name":"1cbf05493820b33ab4cece8a1e7d87c0.png","copyright":null,"legend":null,"width":1200,"height":628}],"videos":[],"openview":0,"url":null,"suggested":[],"paragraphs":[]},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":["VDM introuvable."],"meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: Invalid argument supplied for foreach()"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/{article}/moderate/{mod}":{"get":{"operationId":"api_article_moderate","tags":["articles"],"summary":"Modérer une VDM en attente","description":"Modération par la communauté : `{mod}` vaut `1` (oui, c’est une VDM) ou `0` (non), `0` par défaut. Seules les VDM au statut 0 (new) peuvent être modérées ; récupérez-les avec `/article/list?moderate=1`. Jeton utilisateur ou en-tête `X-VDM-Uniqid` obligatoire (401 sinon) ; un vote par votant et par VDM (406 sinon). Au-delà d’un certain nombre de oui, la VDM passe au statut promoted (2) ; au-delà d’un certain nombre de non, au statut rejected (1). Renvoie les statistiques de la VDM (202).","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"integer"}},{"name":"mod","in":"path","required":true,"schema":{"type":"string","enum":["0","1"]}}],"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"article":57,"comment":0,"favorite":0,"reports":0,"mod_positive":5,"mod_negative":0,"votes_up":0,"votes_down":0,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":["VDM introuvable."],"meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/{article}/vote/{votetype}":{"get":{"operationId":"api_article_vote","tags":["articles"],"summary":"Voter pour une VDM","description":"`{votetype}` est facultatif : sans lui ou avec `0`, le vote est positif ; avec un id de `/article/votetype/list`, il est négatif. Un jeton utilisateur ou `X-VDM-Uniqid` est obligatoire (400 sinon) : un vote par votant, VDM et type de vote (406 sinon). Envoyez la même requête avec la méthode `DELETE` pour retirer un vote. Renvoie les statistiques de la VDM (202).","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"integer"}},{"name":"votetype","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"article":518664,"comment":5,"favorite":1,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":5,"votes_down":13,"smiley_amusing":4,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":["VDM introuvable."],"meta":{},"badge":[],"badge_display":[]}}}},"406":{"description":"Erreur","content":{"application/json":{"example":{"error":"Provided vote type is invalid"}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/{article}/report":{"patch":{"operationId":"api_article_report","tags":["articles"],"summary":"Signaler une VDM","description":"Un jeton utilisateur ou `X-VDM-Uniqid` est obligatoire (400 sinon). Un signalement par votant et par VDM : les appels suivants ne changent rien. Renvoie les statistiques de la VDM (202), 404 si la VDM n’existe pas.","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"article":518672,"comment":0,"favorite":0,"reports":1,"mod_positive":0,"mod_negative":0,"votes_up":0,"votes_down":0,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":"VDM introuvable.","meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/{article}/smile/{smiley}":{"get":{"operationId":"api_article_smile","tags":["articles"],"summary":"Réagir à une VDM avec un smiley","description":"Fonctionne avec un jeton utilisateur ou un en-tête `X-VDM-Uniqid` (401 sans l’un ni l’autre). Les ids de smiley viennent de `/article/smiley/list`. Une réaction par votant, VDM et smiley (406 sinon). Renvoie le nouveau total pour ce smiley (202).","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"integer"}},{"name":"smiley","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":5,"meta":{},"badge":[],"badge_display":[]}}}},"208":{"description":"Erreur","content":{"application/json":{"example":{"error":"Article already voted"}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":"VDM introuvable.","meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/{article}/bookmark":{"patch":{"operationId":"api_article_bookmark","tags":["articles"],"summary":"Ajouter une VDM aux favoris, ou l’en retirer","description":"Bascule : le premier appel ajoute la VDM aux favoris du membre, le suivant l’en retire. Jeton utilisateur obligatoire. Renvoie 202. Listez les favoris avec `/user/{userid}/favorites`.","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":null,"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":"Vous devez être authentifié pour accéder à cette fonction.","meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":"VDM introuvable.","meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/{article}/comments":{"get":{"operationId":"api_article_comments","tags":["articles"],"summary":"Lister les commentaires d’une VDM","description":"Avec pagination (`meta`). Par défaut, les commentaires de premier niveau dans tous les statuts sauf supprimé. Renvoie une liste vide si les commentaires sont fermés sur la VDM. Avec authentification, les commentaires de vos contacts bloqués sont retirés et vos pouces sont inclus.","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"integer"}},{"name":"status","in":"query","description":"tableau d’entiers, facultatif — statuts de commentaire à inclure : 0 normal, 1 mis en avant, 2 nuké, 3 confession, 5 mots interdits, 6 nuké automatiquement ; par défaut : tous sauf 4 (supprimé)","schema":{"type":"array","items":{"type":"integer"}}},{"name":"author","in":"query","description":"tableau d’entiers, facultatif — uniquement les commentaires de ces ids de membre","schema":{"type":"array","items":{"type":"integer"}}},{"name":"parent","in":"query","description":"tableau d’entiers, facultatif — uniquement les réponses à ces ids de commentaire (ex. `parent[]=123`)","schema":{"type":"array","items":{"type":"integer"}}},{"name":"reported","in":"query","description":"booléen, false par défaut — uniquement les commentaires signalés au-delà du seuil du site","schema":{"type":"boolean"}},{"name":"replies","in":"query","description":"booléen, false par défaut — inclut les réponses de chaque commentaire dans sa propriété `replies`","schema":{"type":"boolean"}},{"name":"flat","in":"query","description":"booléen, false par défaut — renvoie commentaires et réponses ensemble, dans une seule liste à plat","schema":{"type":"boolean"}},{"name":"page","in":"query","description":"tableau — pagination : `page[number]` (numéro de page, 1 par défaut) et `page[bypage]` (éléments par page, 30 par défaut)","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true},{"name":"orderby","in":"query","description":"tableau, facultatif — ordre de tri, sous la forme `orderby[champ]=ASC|DESC` ; aucun ordre particulier par défaut","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":170,"date":"2026-10-30T08:50:17+01:00","status":0,"parent":0,"content":"Same thing happened to me last week, you're not alone!","article":518664,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":0,"thumbdown":5,"userthumbed":0,"report":1,"isModerator":false,"replies":null},{"id":171,"date":"2026-10-30T08:51:13+01:00","status":0,"parent":0,"content":"Same thing happened to me last week, you're not alone!","article":518664,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":0,"thumbdown":0,"userthumbed":0,"report":0,"isModerator":false,"replies":null}],"meta":{"page":1,"per_page":2,"page_count":3,"total_count":5},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":"VDM introuvable.","meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/list":{"get":{"operationId":"api_articles","tags":["articles"],"summary":"Lister des VDM","description":"Avec pagination (`meta`). Par défaut, les VDM publiées (statut 4) du site courant, les plus récentes d’abord. Les résultats peuvent être mis en cache jusqu’à une heure. Chaque VDM a une `url` vers sa page web ; avec un jeton utilisateur ou `X-VDM-Uniqid`, vos votes, smileys et favoris sont inclus. `type[]=12` seul renvoie les « presque VDM » (VDM refusées). Exemple : `/article/list?status[]=4&type[]=1&page[number]=1&page[bypage]=10&orderby[datePublish]=desc`.","parameters":[{"name":"site","in":"query","description":"Ignoré : toujours le site courant","schema":{"type":"integer"}},{"name":"moderate","in":"query","description":"booléen, false par défaut — renvoie les prochaines VDM que vous pouvez modérer (VDM au statut 0 pour lesquelles vous n’avez pas voté), voir `/article/{article}/moderate/{mod}`","schema":{"type":"boolean"}},{"name":"spicy","in":"query","description":"booléen, false par défaut — uniquement les VDM épicées","schema":{"type":"boolean"}},{"name":"nospicy","in":"query","description":"booléen, false par défaut — exclut les VDM épicées","schema":{"type":"boolean"}},{"name":"reported","in":"query","description":"booléen, false par défaut — uniquement les VDM signalées au moins une fois","schema":{"type":"boolean"}},{"name":"user","in":"query","description":"entier, facultatif — uniquement les VDM de cet id de membre","schema":{"type":"integer"}},{"name":"country","in":"query","description":"tableau de chaînes, facultatif — uniquement les VDM de ces pays (codes ISO)","schema":{"type":"array","items":{"type":"string"}}},{"name":"type","in":"query","description":"tableau d’entiers, facultatif — uniquement ces types, voir `/article/type/list`","schema":{"type":"array","items":{"type":"integer"}}},{"name":"status","in":"query","description":"tableau d’entiers, `[4]` (validated) par défaut — uniquement ces statuts, voir `/article/status/list` ; les statuts 5 (privé), 7 (supprimé) et 8 (programmé) sont ignorés, sauf pour l’équipe du site","schema":{"type":"array","items":{"type":"integer"}}},{"name":"keyword","in":"query","description":"tableau d’entiers, facultatif — uniquement les VDM liées à ces ids de mot-clé, voir `/article/category/list`","schema":{"type":"array","items":{"type":"integer"}}},{"name":"after","in":"query","description":"chaîne `AAAA-MM-JJ HH:mm:ss`, facultative — uniquement les VDM publiées après cette date","schema":{"type":"string","format":"date-time"}},{"name":"before","in":"query","description":"Actuellement ignoré par l’API (uniquement les VDM publiées avant cette date)","schema":{"type":"string","format":"date-time"}},{"name":"created_after","in":"query","description":"chaîne `AAAA-MM-JJ HH:mm:ss`, facultative — uniquement les VDM créées après cette date","schema":{"type":"string","format":"date-time"}},{"name":"created_before","in":"query","description":"chaîne `AAAA-MM-JJ HH:mm:ss`, facultative — uniquement les VDM créées avant cette date","schema":{"type":"string","format":"date-time"}},{"name":"expr","in":"query","description":"chaîne, facultative — texte à chercher dans le titre et le contenu ; un nombre correspond à l’id de la VDM","schema":{"type":"string"}},{"name":"page","in":"query","description":"tableau — pagination : `page[number]` (numéro de page, 1 par défaut) et `page[bypage]` (éléments par page, 30 par défaut)","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true},{"name":"orderby","in":"query","description":"tableau, `orderby[datePublish]=DESC` par défaut — ordre de tri, sous la forme `orderby[champ]=ASC|DESC` ; seuls les noms de colonnes sont acceptés","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":518664,"status":4,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":"Amusez-vous bien…","content":"","content_hidden":"Aujourd'hui, retour de soirée. Sur la route, ma femme compte combien de lapins nous croisons sur le côté de la route, et me dit que ce serait bête d'en écraser un. Un lapin ? Je n'en ai pas écrasé. Mais un sanglier… VDM","created":"2026-10-06T21:58:24+02:00","updated":"2026-10-21T11:09:45+02:00","published":"2026-10-18T07:55:00+02:00","user":1,"author":"Laure","gender":2,"layout":0,"flag":0,"origin":"api","apikey":"b4e042287442ad81","vote":1,"site":1,"siteorig":null,"slug":"amusez-vous-bien","bitly":null,"metrics":{"article":518664,"comment":0,"favorite":1,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":1,"votes_down":13,"smiley_amusing":1,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":false,"smiley":1,"votes":[0]},"keywords":[],"images":[{"url":"https://localhost:8100/img/62da819fa43dd02828de70822f7b2e70.png/medium/","usage":8,"name":"62da819fa43dd02828de70822f7b2e70.png","copyright":null,"legend":null,"width":1200,"height":628},{"url":"https://localhost:8100/img/1cbf05493820b33ab4cece8a1e7d87c0.png/medium/","usage":9,"name":"1cbf05493820b33ab4cece8a1e7d87c0.png","copyright":null,"legend":null,"width":1200,"height":628}],"videos":[],"openview":0,"url":"https://www.viedemerde.lan/article/amusez-vous-bien_518664.html?modeapp=1","suggested":null,"paragraphs":[]},{"id":22724,"status":12,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":"Merci la RATP","content":"","content_hidden":"Aujourd'hui, dans le métro, un homme joue de l'accordéon à côté de moi. Dans un élan de bonté, je lui tends un ticket restaurant pour qu'il puisse s'acheter à manger. Il s'est arrêté de jouer, m'a regardé et m'a dit : \"Ah non mais je ne fais pas la manche, je suis juste là pou…","created":"2014-10-08T12:48:27+02:00","updated":"2026-10-10T19:39:27+02:00","published":"2026-10-08T18:30:00+02:00","user":1,"author":"N……","gender":null,"layout":0,"flag":0,"origin":"api","apikey":"49b3d5acbfcbc","vote":1,"site":1,"siteorig":null,"slug":"merci-la-ratp","bitly":null,"metrics":{"article":22724,"comment":0,"favorite":0,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":0,"votes_down":3,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":false,"smiley":null,"votes":null},"keywords":[],"images":[{"url":"https://localhost:8100/img/e1e894b355d8789ecf2046c2b654c3fb.png/medium/","usage":8,"name":"e1e894b355d8789ecf2046c2b654c3fb.png","copyright":null,"legend":null,"width":1200,"height":628},{"url":"https://localhost:8100/img/45e39b27e81c9d1ed6fc60b4d830889e.png/medium/","usage":9,"name":"45e39b27e81c9d1ed6fc60b4d830889e.png","copyright":null,"legend":null,"width":1200,"height":628}],"videos":[],"openview":0,"url":"https://www.viedemerde.lan/article/merci-la-ratp_22724.html?modeapp=1","suggested":null,"paragraphs":[]}],"meta":{"page":1,"per_page":2,"page_count":7,"total_count":13},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: Invalid argument supplied for foreach()"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/list/short/{expr}":{"get":{"operationId":"api_article_list_short","tags":["articles"],"summary":"Chercher des VDM pour une autocomplétion","description":"Jeton utilisateur obligatoire. Renvoie jusqu’à 10 VDM publiées correspondant à `{expr}` (dans le titre ou le contenu, ou l’id exact s’il s’agit d’un nombre), sous forme de paires `id`/`title` ; sans titre, le début du contenu est utilisé.","parameters":[{"name":"expr","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":9,"title":"Aujourd'hui, comme tous l..."},{"id":5,"title":"Il manque le stylo !"}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":null,"meta":{"status":"ERROR","msg":"Vous devez être authentifié pour accéder à cette fonction."},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: Invalid argument supplied for foreach()"}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/article/top/{period}":{"get":{"operationId":"api_article_top","tags":["articles"],"summary":"Lister les meilleures VDM","description":"VDM publiées triées par nombre de votes (positifs et négatifs), avec pagination (`meta`). Utilisez `/article/top` pour le classement de tous les temps ou `/article/top/{period}`. Avec un jeton utilisateur ou `X-VDM-Uniqid`, vos votes, smileys et favoris sont inclus.","parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","pattern":"^\\w+$"}},{"name":"period","in":"query","description":"chaîne, dans le chemin, `top` par défaut — `top` (de tous les temps), `top_day`, `top_week`, `top_month` ou `top_year` (VDM publiées le dernier jour, la dernière semaine, le dernier mois ou la dernière année) ; toute autre valeur équivaut à « de tous les temps »","schema":{"type":"string"}},{"name":"page","in":"query","description":"tableau — pagination : `page[number]` (numéro de page, 1 par défaut) et `page[bypage]` (éléments par page, 30 par défaut)","schema":{"type":"object","additionalProperties":{"type":["string","integer"]}},"style":"deepObject","explode":true}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":8,"status":4,"type":1,"spicy":false,"optin":false,"socialTruncate":false,"title":"","content":"Aujourd'hui, le grand patron du supermarché dans lequel je travaille est venu nous rendre visite. Il a estimé que les rayons étaient trop bien rangés et que par conséquent il y a avait trop de personnel. Nous sommes deux dans l'équipe, et c'est moi qui ai tout rangé hier après…","content_hidden":"Aujourd'hui, le grand patron du supermarché dans lequel je travaille est venu nous rendre visite. Il a estimé que les rayons étaient trop bien rangés et que par conséquent il y a avait trop de personnel. Nous sommes deux dans l'équipe, et c'est moi qui ai tout rangé hier après…","created":"2026-09-29T20:29:41+02:00","updated":"2026-10-04T10:19:37+02:00","published":"2026-10-04T08:19:37+02:00","user":2321654987,"author":null,"gender":null,"layout":0,"flag":0,"origin":null,"apikey":null,"vote":2,"site":1,"siteorig":null,"slug":"aujourd-hui-le-grand-patron-du-supermarche-dans-lequel-je-travaille-est-venu-nous-rendre-visite-i","bitly":null,"metrics":{"article":8,"comment":14,"favorite":0,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":34,"votes_down":35,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":false,"smiley":null,"votes":null},"keywords":[],"images":[{"url":"https://localhost:8100/img/bd23c56532ea00209cdf5add9bb60da1.png/medium/","usage":8,"name":"bd23c56532ea00209cdf5add9bb60da1.png","copyright":null,"legend":null,"width":1200,"height":628},{"url":"https://localhost:8100/img/1dd5c32cbc75ef1d81be29e324535d55.png/medium/","usage":8,"name":"1dd5c32cbc75ef1d81be29e324535d55.png","copyright":null,"legend":null,"width":1200,"height":628}],"videos":[],"openview":0,"url":null,"suggested":null},{"id":5,"status":4,"type":2,"spicy":false,"optin":false,"socialTruncate":false,"title":"Il manque le stylo !","content":"Aujourd'hui, bac de littérature. Je ne me rends compte qu'une fois dans la salle d'examen que j'ai seulement pris de quoi manger, pas de quoi écrire. VDM","content_hidden":"Aujourd'hui, bac de littérature. Je ne me rends compte qu'une fois dans la salle d'examen que j'ai seulement pris de quoi manger, pas de quoi écrire. VDM","created":"2026-09-29T20:29:39+02:00","updated":"2026-10-12T16:28:48+02:00","published":"2026-10-04T07:43:16+02:00","user":2321654987,"author":null,"gender":null,"layout":0,"flag":0,"origin":null,"apikey":null,"vote":1,"site":1,"siteorig":null,"slug":"il-manque-le-stylo","bitly":null,"metrics":{"article":5,"comment":5,"favorite":0,"reports":0,"mod_positive":0,"mod_negative":0,"votes_up":0,"votes_down":58,"smiley_amusing":0,"smiley_funny":0,"smiley_weird":0,"smiley_hilarious":0},"usermetrics":{"favorite":false,"smiley":null,"votes":null},"keywords":[],"images":[{"url":"https://localhost:8100/img/d17c18a3cd79b3da1118b522d3f8a4b4.png/medium/","usage":8,"name":"d17c18a3cd79b3da1118b522d3f8a4b4.png","copyright":null,"legend":null,"width":1200,"height":628},{"url":"https://localhost:8100/img/4efca042feb3f51ff16e73b8883d338e.png/medium/","usage":9,"name":"4efca042feb3f51ff16e73b8883d338e.png","copyright":null,"legend":null,"width":1200,"height":628}],"videos":[],"openview":0,"url":null,"suggested":null}],"meta":{"page":1,"per_page":30,"page_count":1,"total_count":12},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/comment/{article}":{"post":{"operationId":"api_comment_create","tags":["comments"],"summary":"Commenter une VDM","description":"Jeton utilisateur obligatoire. Renvoie le commentaire (201), 400 si le contenu est vide, 404 si la VDM n’existe pas ou si `parent` n’est pas un commentaire de cette VDM. Si le commentaire est une réponse, l’auteur du commentaire parent est notifié. Un membre peut commenter une fois toutes les 30 secondes. Les commentaires contenant des mots interdits sont signalés.","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"chaîne, obligatoire — texte du commentaire"},"parent":{"type":"string","description":"entier, facultatif — id du commentaire auquel vous répondez"}},"required":["content"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"chaîne, obligatoire — texte du commentaire"},"parent":{"type":"string","description":"entier, facultatif — id du commentaire auquel vous répondez"}},"required":["content"]}}}},"responses":{"201":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":175,"date":null,"status":0,"parent":0,"content":"Same thing happened to me last week, you're not alone.","article":518664,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":0,"thumbdown":0,"userthumbed":0,"report":0,"isModerator":false,"replies":null},"meta":{},"badge":[],"badge_display":[]}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"No comment provided."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":["Vous devez être authentifié pour accéder à cette fonction."],"meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":["VDM introuvable."],"meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/comment/{comment}/edit":{"post":{"operationId":"api_comment_edit","tags":["comments"],"summary":"Modifier un de vos commentaires","description":"Jeton utilisateur obligatoire. Vous ne pouvez modifier que vos propres commentaires (400 sinon). Renvoie le commentaire modifié (201).","parameters":[{"name":"comment","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"chaîne, obligatoire — nouveau texte du commentaire"}},"required":["content"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"chaîne, obligatoire — nouveau texte du commentaire"}},"required":["content"]}}}},"responses":{"201":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":175,"date":"2026-10-30T08:56:00+01:00","status":0,"parent":0,"content":"Same thing happened to me last week, you're not alone!","article":518664,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":0,"thumbdown":0,"userthumbed":0,"report":0,"isModerator":false,"replies":null},"meta":{},"badge":[],"badge_display":[]}}}},"400":{"description":"Erreur","content":{"application/json":{"example":{"error":"No comment provided."}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":["Vous devez être authentifié pour accéder à cette fonction."],"meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":["VDM introuvable."],"meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: file_get_contents(): php_network_getaddresses: getaddrinfo failed: Name or service not known"}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/comment/{comment}/{replies}":{"get":{"operationId":"api_comment","tags":["comments"],"summary":"Récupérer un commentaire par son id","description":"Utilisez `/comment/{comment}/replies` pour inclure les réponses du commentaire. Avec authentification, vos pouces sont inclus. Renvoie 404 si le commentaire n’existe pas.","parameters":[{"name":"comment","in":"path","required":true,"schema":{"type":"integer"}},{"name":"replies","in":"path","required":true,"schema":{"type":"string","enum":["replies"]}},{"name":"comment","in":"query","description":"entier, dans le chemin — id du commentaire","schema":{"type":"string"}},{"name":"replies","in":"query","description":"facultatif, dans le chemin — le mot `replies` tel quel, pour inclure les réponses","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":170,"date":"2026-10-30T08:50:17+01:00","status":0,"parent":0,"content":"Same thing happened to me last week, you're not alone!","article":518664,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":0,"thumbdown":5,"userthumbed":0,"report":1,"isModerator":false,"replies":null},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"error":"102 - Invalid API key."}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":[""],"meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: Invalid argument supplied for foreach()"}}}}},"security":[{"apiKey":[]},{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/comment/{comment}/up/{inc}":{"patch":{"operationId":"api_comment_up","tags":["comments"],"summary":"Mettre un pouce levé à un commentaire","description":"Jeton utilisateur obligatoire. Un pouce par membre et par commentaire : répéter l’appel ne change rien, et passer d’un pouce levé à un pouce baissé (ou l’inverse) déplace le pouce. Renvoie le commentaire (202).","parameters":[{"name":"comment","in":"path","required":true,"schema":{"type":"integer"}},{"name":"inc","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"entier, dans le chemin — id du commentaire"},"inc":{"type":"string","description":"entier, dans le chemin — ignoré : toujours un pouce"}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"entier, dans le chemin — id du commentaire"},"inc":{"type":"string","description":"entier, dans le chemin — ignoré : toujours un pouce"}}}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":170,"date":"2026-10-30T08:50:17+01:00","status":0,"parent":0,"content":"Same thing happened to me last week, you're not alone!","article":518664,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":0,"thumbdown":5,"userthumbed":0,"report":1,"isModerator":false,"replies":null},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":"Vous devez être authentifié pour accéder à cette fonction.","meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":"","meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: Invalid argument supplied for foreach()"}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/comment/{comment}/down/{inc}":{"patch":{"operationId":"api_comment_down","tags":["comments"],"summary":"Mettre un pouce baissé à un commentaire","description":"Jeton utilisateur obligatoire. Un pouce par membre et par commentaire : répéter l’appel ne change rien, et passer d’un pouce levé à un pouce baissé (ou l’inverse) déplace le pouce. Un commentaire qui reçoit trop de pouces baissés est masqué automatiquement (statut 6, auto-nuked). Renvoie le commentaire (202).","parameters":[{"name":"comment","in":"path","required":true,"schema":{"type":"integer"}},{"name":"inc","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"entier, dans le chemin — id du commentaire"},"inc":{"type":"string","description":"entier, dans le chemin — ignoré : toujours un pouce"}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"entier, dans le chemin — id du commentaire"},"inc":{"type":"string","description":"entier, dans le chemin — ignoré : toujours un pouce"}}}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":170,"date":"2026-10-30T08:50:17+01:00","status":0,"parent":0,"content":"Same thing happened to me last week, you're not alone!","article":518664,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":-1,"thumbdown":6,"userthumbed":0,"report":1,"isModerator":false,"replies":null},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":"Vous devez être authentifié pour accéder à cette fonction.","meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":"","meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: Invalid argument supplied for foreach()"}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/comment/{comment}/report":{"patch":{"operationId":"api_comment_report_abuse","tags":["comments"],"summary":"Signaler un commentaire","description":"Jeton utilisateur obligatoire. Un signalement par membre et par commentaire. Renvoie le commentaire (202), 404 s’il n’existe pas.","parameters":[{"name":"comment","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"entier, dans le chemin — id du commentaire à signaler"}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"entier, dans le chemin — id du commentaire à signaler"}}}}}},"responses":{"202":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":170,"date":"2026-10-30T08:50:17+01:00","status":0,"parent":0,"content":"Same thing happened to me last week, you're not alone!","article":518664,"author":{"id":4294967294,"username":"JohnDoe","avatar":"/images/default-avatar.jpg","title":"mr"},"thumbup":0,"thumbdown":6,"userthumbed":0,"report":1,"isModerator":false,"replies":null},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":"Vous devez être authentifié pour accéder à cette fonction.","meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":"","meta":{},"badge":[],"badge_display":[]}}}},"500":{"description":"Erreur","content":{"application/json":{"example":{"error":"Warning: Invalid argument supplied for foreach()"}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/badge/{badgeid}":{"get":{"operationId":"api_badge","tags":["badges"],"summary":"Récupérer un badge par son id","description":"Jeton utilisateur obligatoire. Renvoie 404 si le badge n’existe pas.","parameters":[{"name":"badgeid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"badgeid","in":"query","required":true,"description":"entier, obligatoire — id du badge","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":{"id":1,"site":null,"name":"Débutant","description":"Vous avez parcouru 5 pages du site. C'est un début.","hidden":"0","goal":5,"limited":"0","category":1,"total":7698968,"illustration":"lI6nHr5hWXlu0.gif"},"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":["Vous devez être authentifié pour accéder à cette fonction."],"meta":{},"badge":[],"badge_display":[]}}}},"404":{"description":"Erreur","content":{"application/json":{"example":{"data":"Badge not found.","meta":{},"badge":[],"badge_display":[]}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}},"/badge/list":{"get":{"operationId":"api_badge_list","tags":["badges"],"summary":"Lister les badges","description":"Jeton utilisateur obligatoire. Renvoie tous les badges, sauf les badges cachés.","responses":{"200":{"description":"Succès","content":{"application/json":{"example":{"data":[{"id":1,"site":null,"name":"Débutant","description":"Vous avez parcouru 5 pages du site. C'est un début.","hidden":"0","goal":5,"limited":"0","category":1,"total":7698968,"illustration":"lI6nHr5hWXlu0.gif"},{"id":2,"site":null,"name":"Profil rempli","description":"Vous avez le souci du détail. Voilà qui sera apprécié.","hidden":"0","goal":1,"limited":"0","category":1,"total":192675,"illustration":"2.gif"}],"meta":{},"badge":[],"badge_display":[]}}}},"401":{"description":"Erreur","content":{"application/json":{"example":{"data":["Vous devez être authentifié pour accéder à cette fonction."],"meta":{},"badge":[],"badge_display":[]}}}}},"security":[{"apiKey":[],"memberToken":[]},{"apiKey":[],"oauth2":["api"]}]}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-VDM-Api-Key","description":"Votre clé d'API (https://apps.viedemerde.fr/keys)"},"memberToken":{"type":"apiKey","in":"header","name":"X-VDM-Api-Token","description":"Le jeton d'un membre"},"oauth2":{"type":"oauth2","description":"Connexion avec VDM (https://apps.viedemerde.fr/docs/oauth)","flows":{"authorizationCode":{"authorizationUrl":"https://www.viedemerde.fr/oauth/authorize","tokenUrl":"https://www.viedemerde.fr/oauth/token","scopes":{"api":"L'API au nom du membre"}}}}}}}