REST-Antwort - soll ich die URL-Adresse der neuen Ressource in die Kopf, Körper, oder beides?

Ich haben zusammen eine API, die eine Antwort auf eine POST-Anforderung, indem die Inhalte der neuen Ressource im response-body, und die URL-Adresse der neuen Ressource in der Lage, HTTP-Antwort-header.

Beispiel-Anfrage:

POST /api/v1/widgets HTTP/1.1
Content-type: application/json;
Accept: application/json;

{
    "name": "[email protected]",
    "price": "10",
}

Beispiel-Antwort:

HTTP 201 Created
Location: http://example.com/api/v1/widgets/123456

{
    'widget': 
    {
        'id': "123456",
        'created': "2012-06-22T12:43:37+0100",
        'name': "[email protected]",
        'price': "10",
    },
}

Jemand hat ein Problem angesprochen, dass die URL sollte auch in den Text der Antwort. Gibt es eine best practice?

(Fühlen Sie sich frei, um zu töten, wenn es zu subjektiv, nicht sicher, ob dies gegen den Geist der SO oder SO nicht)

InformationsquelleAutor Hugo Rodger-Brown | 2012-06-22

Schreibe einen Kommentar