Eine REST-API kann auf mindestens zwei Arten Parameter haben:
- Als Teil des URL-Pfads (d.h.
/api/resource/parametervalue
) - Als Abfrageargument (d.h.
/api/resource?parameter=value
)
Was ist hier die beste Praxis? Gibt es allgemeine Leitlinien, wann 1 und wann 2 zu verwenden ist?
Beispiel aus der Praxis: Twitter verwendet Abfrageparameter zur Angabe von Intervallen. ( http://api.twitter.com/1/statuses/home_timeline.json?since_id=12345&max_id=54321
)
Wäre es besser, diese Parameter in den URL-Pfad aufzunehmen?