Bonjour,
Je recherche qqn qui a déjà créer une apiREST dans un milieu professionel. (cakePHP ou autre)
Je suis dans une entreprise ou on a plein de micro api qui tournent pas vraiment ensemble, et on a décider de creér une API pour toutes les controllers ! et aussi pour eventuellement ouvrir certaines routes de notre api a certains de nos clients.
A ce stade, on a choisit swagger pour creer notre doc, mais on hésite sur le fomatage ne nos objets Json
d'un coté, on a : https://github.com/FriendsOfCake/crud
qui fait que le retour de l'api sur une GET par exemple ressembleras a qqch comme ca :
{
"success": true,
"data": {
///
},
"pagination": {
...
}
}
Mais ca ne respecte pas vraiment la norme OAS, d'ailleur qqn peut me parler de cette norme plus en detail ?
Mais il y a aussi Json:API : https://github.com/FriendsOfCake/crud-json-api - http://jsonapi.org/
Mais il faut un interpretteur coté client parce que l'objet est difficillement traittable en l'etat...
Quelqu'un aurait de la doc ou des conseils a me fournir sur les bonnes pratiques pour créer une api et m'aiguiller si jamais Vous connaissez...
Merci :)