Cake3 & apiREST

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 :)