UserPreferences

AtomApiTestPostHtml


Atom API POST request validation/interpretation rules -- HTML format

See AtomApiTest, ParticleWave, AtomApiTestDiscussion

Request

<html><head><meta name="atom.id" content="http://example.org/e48">:

<html><head><meta name="atom.entry.uri" content="URI">:

<html><head><title>:

<html><head><meta name="description" content="Citrus fruit wholesaler.">:

<html><body>:

<html><head><meta name="DC.Date.Issued" content="20031103">:

<html><head><meta name="DC.Date.Modified" content="20031103">

<html><head><meta name="DC.Date.Created" content="20031103">:

<html><head><meta name="DC.Creator" content="Jane Doe">:

<html><head><meta name="DC.Contributor" content="John Roe">:

<html><head><meta name="generator" content="Name/1.0">:

Response

Expected status codes from a POST are 201, 400, and 500. 401, 404, and 410 are also possible.

201 specifies the location of the resource created. Response includes a Location: header with the URI of the created resource, i.e. the URI used to edit the entry (as opposed to the URI used to display the content). The body of the response will contain the entry "filled in" with time stamps and any other data the server choses to reveal. This must contain enough information to enable a client to issue a subsequent PUT to this location. Note: the server may chose to omit the content in the response, particularly if it is large.

400 indicates that the server believes that that data sent constitutes an invalid request. A short description of the error will appear on the status line itself. A longer description (in plain text format) will appear in the body.

500 indicates that the server detected an internal error on the server processing this request (such as an unhandled exception). A short description of the error will appear on the status line itself. A longer description (in plain text format) will appear in the body.