Livrer une API que dâautres Ă©quipes peuvent utiliser
« LâĂ©quipe mobile doit pouvoir lire nos donnĂ©es dâici le prochain sprint. » Quelquâun finit toujours par vouloir parler Ă vos donnĂ©es : une application mobile, le systĂšme dâun partenaire, un front construit par une autre Ă©quipe. Cela veut dire des endpoints, de la validation des requĂȘtes, des rĂ©ponses dâerreur cohĂ©rentes et une documentation qui ne se pĂ©rime pas Ă la premiĂšre modification du code. Ăcrire tout cela Ă la main pour chaque ressource, câest prĂ©cisĂ©ment le travail rĂ©pĂ©titif que lâoutillage PHP existe pour supprimer.
La décision porte sur ce que vous voulez voir généré pour vous, et ce que vous préférez garder explicite.
- API Platform : une API complĂšte Ă partir dâune classe PHP gĂ©nĂšre REST, GraphQL et la documentation OpenAPI depuis une seule classe annotĂ©e.
- Laravel : Sanctum, Resources et versions dâAPI, lâapproche plus lĂ©gĂšre, plus manuelle et plus rĂ©pandue.
- WordPress : lâAPI REST intĂ©grĂ©e, ce quâun site WordPress expose dĂ©jĂ avant que vous nâinstalliez quoi que ce soit.