RESTful URLs für einen Suchdienst, der mit einer beliebigen Anzahl von Kriterien filtern

Ich bauen will ein RESTful web service implementiert, dass ein such-interface für eine Datenbank für biologische Daten.

Eine typische Suchanfrage, die bedeuten könnte, ein Dutzend oder so Attribute der Daten.
Zum Beispiel, suchen Sie nach wissenschaftlichen Namen begrenzen Sie die Suche auf Wassertiefen von weniger als 100m.
Mein Erster Instinkt ist, um alle Attribute in der Abfrage-string
z.B. ?searchType=sciname&sciname=mola+mola&maxdepth=100&mindepth=0

Jedoch, query-strings werden als nicht Erholsam ist, sehen http://rest.blueoxen.net/cgi-bin/wiki.pl?QueryStringsConsideredHarmful

Ich habe mir bei einigen früheren SO Diskussionen wie RESTful-URL-design für die Suche
und ich bin mir immer noch nicht klar in diesem Punkt, so meine Frage:

Ist es eine akzeptierte Norm oder das Muster für RESTful URLs für einen Suchdienst, wo es möglicherweise eine beliebige Anzahl
filtern von Werten?

  • Was ist der name der Ressource, die Sie sind GETting? Die searchType query-parameter in deinem Beispiel macht mich ein bisschen misstrauisch (mit Bezug auf Ihren service, der RESTful).
  • Wie übernehme ich Antworten?
InformationsquelleAutor user24989 | 2009-12-01
  1. 10

    In der REST-style Web:

    • Die Pfad Bestandteil der Anfrage-uri identifiziert eine bestimmte Ressource.
    • Die query-string Bestandteil der Anfrage-uri identifiziert irgendwelche besonderen Filter oder änderungen gemacht bei der Vorstellung, dass die Ressource.
    • Die Akzeptieren header kennzeichnet einen bestimmten content-Typ, in der die vorliegende Ressource gefiltert, wie angegeben, dargestellt werden soll.
    • Die Accept-Language header kennzeichnet eine Besondere Sprache, in der die vorliegende Ressource gefiltert, wie angegeben, dargestellt werden soll.

    Also um deine Frage zu beantworten:

    GET /species?searchType=sciname&sciname=mola+mola&maxdepth=100&mindepth=0

    perfekt angemessen ist.

    • Cool, das klingt besser. Ich bin immer noch Fragen, über seine 'searchType' parameter. Es scheint fast überflüssig. Ich bin auf die OP ' s Antwort zu meinem Kommentar auf die Frage.
    • Ja, es kann nicht notwendig sein. Ich wollte nicht in diese zu bekommen, nur weil der wichtigste Teil war die Art erklären, wie man Zugriffe auf eine Ressource, und wie man mit Anfragen der Ressource gefiltert werden, die im REST-Stil.
    • Ich war nicht allzu deutlich auf die Basis-url Teil, weil ich konzentriert war, auf den Abfrage-string. /Spezies ist, was ich darüber nachdachte. Allerdings war ich zwei Versionen: eine für ein einfaches abrufen der Datensätze für eine Spezies und eine für eine gefilterte Anfrage. Zum Beispiel: /Spezies/mola+mola ... alle Datensätze zurück /Arten/mola+mola/gefiltert?maxdepth=100,numrecs=1000 ...filter auf die Tiefe und die Anzahl der zurückgegebenen Datensätze
    InformationsquelleAutor yfeldblum
Schreibe einen Kommentar