Rückgabe von true/false in der REST-service?

Ich bin der Gestaltung einer REST-Dienst, und es gibt eine Notwendigkeit für eine überprüfung zu sehen, ob eine Adresse richtig eingegeben ist. Was ich denken werde, ist, wie würden Sie entwerfen eine REST-Schnittstelle für die überprüfung, ob eine vollständige Adresse gültig ist.

Habe ich diese /Adresse service und ich könnte zum Beispiel tun, eine POST /address/validation das gibt einen xml - /json-true oder false, aber es scheint ziemlich un-REST-ful für mich.

Andere Möglichkeit wäre eine GET /address?street=xxx&nr=xxx&zipcode=xxx (und ein paar mehr Parameter) und wieder ein 200 OK, wenn richtige oder eine 404-Nicht gefunden, wenn nicht korrekt, die möglicherweise mehr REST-ful?

Begann ich option 1) aber je mehr ich darüber nachdenke, option 2) mit der GET-fühlt sich besser...

Ideen?

InformationsquelleAutor Johan Danforth | 2011-04-28
  1. 7

    Aus einem Erholsamen Perspektive, du bist echt der Rückkehr eine neue Ressource, nennen es AddressValidation, die mit Ihrem true-oder false-Wert. So ein Ansatz wäre, um einen BEITRAG zu /addressvalidation?street=xxx etc. Ich würde sein fein mit der Rückkehr das Ergebnis als JSON oder mithilfe von status-codes. Ich bin mir nicht sicher, 404 ist angemessen, obwohl, möchten Sie vielleicht zu schauen,diese Diskussion der Validierung status-codes.

    Ich habe das gleiche Problem mit der GET /address?street=xxx&nr=xxx&zipcode=xxx Ansatz, wie Sie es vorschlagen. Zu mir, wenn es gibt 404 zurück, d.h. die Adresse ist buchstäblich nicht gefunden (D. H. nicht in der Datenbank vorhanden sind), anstatt, dass es ungültig ist (z.B. die Postleitzahl ein ungültiges format; es kann keine solche Adresse). Wieder, finden Sie in der verlinkten Diskussion; wie es scheint, 400 ist eine geeignete Antwort.

    • Dank Jakob. Wir sind eigentlich Los, um zu testen, 2 Dinge, die hier - sowohl, wenn die Adresse im richtigen format ein, und nach, dass wir überprüfen, um zu sehen, ob die Adresse tatsächlich existiert. Diese sind, wie du sagst, zwei verschiedene Dinge und sollten unterschiedliche codes zurückgeben/Daten.
    InformationsquelleAutor Jacob Mattison
  2. 5

    Wie wärs?

    GET /addressValidity?street=xxx&nr=xxx&zipcode=xxx
=> 
200 OK
Content-Type: text/plain

true
    • Dank Darrel, es ist einfach und ich mag es. Es fällt außerhalb unserer normalen Verhalten von immer wiederkehrenden xml-oder json-depeding auf accept-Header, obwohl.
    • Natürlich können Sie jeden beliebigen Medien-Typ, den Sie mögen. Text/plain ist nur schön für Rückgabe einfache Skalare Werte. Es ist bedauerlich, dass die aktuelle Besessenheit für "xml-oder json -" wirklich verliert einige der Vorteile, die RUHE bringt, mit der Fähigkeit, viele verschiedene Medientypen.
    • Sie können ein Objekt zurückgeben, wie { "result": true }
    • Zu sagen, dass Sie zurückkehren können, ein "Objekt" über HTTP ist nicht wirklich ausreichend, da die definition, was ein Objekt ist hängt entweder eine Programmiersprache, Plattform oder Medien-Typ-Spezifikation. Was Sie gezeigt haben, ist eine JSON-Darstellung enthält, was JSON definiert als ein Objekt. Dass Sie zurückkehren können. Es ist overkill, aber es funktioniert.
    InformationsquelleAutor Darrel Miller
  3. -2

    Fühle ich mich dabei POST und die Rückkehr status-Code (200 OK, wenn richtige oder eine 404-Nicht gefunden, wenn nicht korrekt) mehr erholsam. Da Sie nicht Immer etwas BEKOMMEN, sieht nicht angebracht. Sie Buchen einige Informationen zum server und es führt einige Verarbeitung (Validierung) und gibt einige Antwort.

    • POST sieht nicht alle gut für diese, wenn Sie mich Fragen. Die RFC besagt, "Die POST-Methode wird verwendet, um anzufordern, dass der Ursprungs-server akzeptieren Sie die Einheit eingeschlossen in der Anforderung als eine neue untergeordnete der Ressource identifiziert durch die Request-URI im Request-Line"
    • Erhalten ist besser als POST in diesem Fall, weil die operation ist idempotent
    InformationsquelleAutor Reddy
Schreibe einen Kommentar