- Belgium
- http://tcaresset.com
-
admin of herisson
- Joined on
2022-03-15
si tu appliques les précédents commentaire tu as soit le choix de laisser le post dans /Requests/{type} soit de le mettre avec /Requests et dans ce cas il suffit de mettre le type en paramètre dans requestBody ou dans query (je pense que requestBody serait mieux dans le cas présent)
Le fait de metre des end-points n'a rien à voir avec le stockage d'information tho. ton end point peut être clair et concis tandis que ta base de données et ton backend s'occupent de chercher…
ha je pense que ça doit être dans un requestBody tho. je vais faire des test. je t'ai juste pondu ce que j'ai trouvé dans la doc
Pour l'instant pour que ça fasse plus bô j'ai mis tout les tags en commençant avec une majuscule. c'est mineur mais ça serait cool ^^
Franchement pas mal, j'ai fait beaucoup de commentaire mais c'est principalement des clarification sur la syntaxe. ça ne devrais pas être trop long à changer je pense.
quand il y a un 'security' tag c'est toujours bien d'envisager l'erreur de permission:
ce endpoint permet l'accés à "information about yourself" donc je ne vois pas comment il pourrais être paramètrisé par sa fonction ^^
C'est sympa de faire des schema pour avoir une bonne description mais il ne sont jamais utilisé. pour les utiliser tu peux faire
summary permet une courte description. il y'a également le tag description qui peut être pratique pour une plus grande description.