Carnet de notes

Étiquette : API

  • The lie of the API

    Quelques réponses sur un billet qui a beau­coup circulé : The lie of the API. Ça flatte beau­coup la mouvance HATEOAS mais je n’ac­croche pas. Même avec des clients très smart, impos­sible de faire un même site pour les visites « navi­ga­teur » et les accès « API ». Le logi­ciel client de l’API ne sera jamais assez intel­li­gent pour…

  • Défi­nir son API : version­ne­ment

    Toujours dans la logique de réflé­chir son API, parce qu’un jour il faudra la faire évoluer, comment gérer le version­ne­ment ? Plusieurs solu­tions ont émergé : https://api-v2.example.com/mares­source https://api.example.com/v2/mares­source https://api.example.com/mares­source-v2 https://api.example.com/mares­source?v=2 https://api.example.com/mares­source avec une entête Version: 2 https://api.example.com/mares­source avec une entête Accept ou/et Content-type: appli­ca­tion/monfor­mat;version=2 La solu­tion du sous-domaine n’est à mon sens à réser­ver que pour les…

  • Défi­nir son API : authen­ti­fi­ca­tion

    Je lis le PDF gratuit de Apigee à propos du design des API web. Si les autres PDF gratuits du site sont assez creux, celui là pose de bonnes ques­tions qui font écho avec mes propres reflexions. Je le prends dans le désordre et pour reprendre mes erreurs passées ou celles que j’ai vu chez…