W3C home > Mailing lists > Public > ietf-http-wg@w3.org > October to December 2010

#230: Considerations for registering new methods

From: Mark Nottingham <mnot@mnot.net>
Date: Tue, 19 Oct 2010 17:04:24 +1100
Message-Id: <C0A99197-900C-42FF-A11C-55FCA6CFD2EE@mnot.net>
To: HTTP Working Group <ietf-http-wg@w3.org>

I've incorporated the proposal below as a starting point:


When it is necessary to express new semantics for a HTTP request that aren't specific to a single application or media type, and currently defined methods are inadequate, it may be appropriate to register a new method [ref].

New methods SHOULD be potentially applicable to any resource. I.e., they should not be specific to any particular media type, "type" of resource, or application.

New methods MUST NOT prohibit a message-body on either the request or the response message; however they MAY specify that only a zero-length body is allowed.

New methods MUST define whether they are safe [ref] and whether they are idempotent [ref]. They MUST also state whether they can be cached [ref to p6]; in particular what conditions a cache may store the response, and under what conditions such a stored response may be used to satisfy a subsequent request.

New methods SHOULD explain how conditional request headers [ref] affect the response (if there is any effect).

HTTP methods SHOULD be registered in a document that isn't specific to an application or other use of HTTP, so that it's clear that they are not specific to that application or extension.


I expect we'll find more here, but wanted to get something in. Feedback appreciated, as always.

Mark Nottingham   http://www.mnot.net/
Received on Tuesday, 19 October 2010 06:04:59 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 1 March 2016 11:10:55 UTC