Partage
  • Partager sur Facebook
  • Partager sur Twitter

modélisation API REST

problème de naming

    17 septembre 2020 à 18:16:01

    Bonjour,

    je bosse sur plusieurs API mais je suis bloqué sur un problème bloquant. Je veux exposer un endpoint pour récupérer la liste des personnes qui sont dans une tour. J'ai pensée à deux solutions:

    http://URL/api/tours/{nom-tour}/personnes
    http://URL/api/personnes?nom-tour={nom-tour}

    Je ne sais pas c'est quoi la meilleure solution. Vous en pensez quoi ? 

    Merci.

    • Partager sur Facebook
    • Partager sur Twitter
      23 septembre 2020 à 5:10:01

      http://URL/api/tours/{nom-tour}/personnes
      Ce format est celui que j'ai le plus rencontre en bossant avec des API REST. Je pencherais donc pour celui la.
      • Partager sur Facebook
      • Partager sur Twitter
        23 septembre 2020 à 19:41:32

        En effet c'est mieux de mettre :

        https://domain.tld/api/ressources/{identifier}/sub_ressources


        Car les query parameters (ce que tu mets avec le ?key=value) peuvent servir de manière plus générique comme par exemple une pagination (?p=2) ou pour trier par exemple (?name=asc)

        • Partager sur Facebook
        • Partager sur Twitter

        modélisation API REST

        × Après avoir cliqué sur "Répondre" vous serez invité à vous connecter pour que votre message soit publié.
        × Attention, ce sujet est très ancien. Le déterrer n'est pas forcément approprié. Nous te conseillons de créer un nouveau sujet pour poser ta question.
        • Editeur
        • Markdown