The Hyper Text Coffee Pot Control Protocol for Tea Efflux Appliances (HTCPCP-TEA)
RFC 7168
Document | Type |
RFC - Informational
(April 2014; No errata)
Updates RFC 2324
|
|
---|---|---|---|
Last updated | 2014-04-01 | ||
Stream | ISE | ||
Formats | plain text pdf html bibtex | ||
Stream | ISE state | (None) | |
Consensus Boilerplate | Unknown | ||
Document shepherd | No shepherd assigned | ||
IESG | IESG state | RFC 7168 (Informational) | |
Telechat date | |||
Responsible AD | (None) | ||
Send notices to | (None) |
Independent Submission I. Nazar Request for Comments: 7168 1 April 2014 Updates: 2324 Category: Informational ISSN: 2070-1721 The Hyper Text Coffee Pot Control Protocol for Tea Efflux Appliances (HTCPCP-TEA) Abstract The Hyper Text Coffee Pot Control Protocol (HTCPCP) specification does not allow for the brewing of tea, in all its variety and complexity. This paper outlines an extension to HTCPCP to allow for pots to provide networked tea-brewing facilities. Status of This Memo This document is not an Internet Standards Track specification; it is published for informational purposes. This is a contribution to the RFC Series, independently of any other RFC stream. The RFC Editor has chosen to publish this document at its discretion and makes no statement about its value for implementation or deployment. Documents approved for publication by the RFC Editor are not a candidate for any level of Internet Standard; see Section 2 of RFC 5741. Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc7168. Copyright Notice Copyright (c) 2014 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Nazar Informational [Page 1] RFC 7168 HTCPCP-TEA 1 April 2014 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . . 3 2. HTCPCP-TEA Protocol Additions . . . . . . . . . . . . . . . . . 3 2.1. BREW and POST Methods . . . . . . . . . . . . . . . . . . . 3 2.1.1. The "/" URI . . . . . . . . . . . . . . . . . . . . . . 3 2.1.2. Variety-Specific URIs . . . . . . . . . . . . . . . . . 4 2.2. Modified Header Fields . . . . . . . . . . . . . . . . . . 4 2.2.1. The Accept-Additions Header Field . . . . . . . . . . . 4 2.3. Response Codes . . . . . . . . . . . . . . . . . . . . . . 5 2.3.1. 300 Multiple Options . . . . . . . . . . . . . . . . . 5 2.3.2. 403 Forbidden . . . . . . . . . . . . . . . . . . . . . 5 2.3.3. 418 I'm a Teapot . . . . . . . . . . . . . . . . . . . 5 3. The "message/teapot" Media Type . . . . . . . . . . . . . . . . 6 4. Environmental Considerations . . . . . . . . . . . . . . . . . 6 5. Security Considerations . . . . . . . . . . . . . . . . . . . . 6 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 7 7. References . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7.1. Normative References . . . . . . . . . . . . . . . . . . . 7 7.2. Informative References . . . . . . . . . . . . . . . . . . 7 1. Introduction As noted in the Hyper Text Coffee Pot Control Protocol [HTCPCP], coffee is renowned worldwide as an artfully brewed caffeinated beverage, but coffee shares this quality with many other varied preparations based on the filtration of plant material. Foremost, among these are the category of brews based on the straining of water through prepared leaves from a tea tree: the lineage and history of the tea genus will not be recounted as part of this paper, but evidence shows that the production of tea existed many thousands of years ago. The deficiency of HTCPCP in addressing the networked production of such a venerable beverage as tea is noteworthy: indeed, the only provision given for networked teapots is that they not respond to requests for the production of coffee, which, while eminently reasonable, does not allow for communication with the teapot for its intended purpose. This paper specifies an extension to HTCPCP to allow communication with networked tea production devices and teapots. The additions to the protocol specified herein permit the requests and responses necessary to control all devices capable of making, arguably, the most popular caffeinated hot beverage. Nazar Informational [Page 2] RFC 7168 HTCPCP-TEA 1 April 2014 1.1. Terminology The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [KEYWORDS]. 2. HTCPCP-TEA Protocol Additions The TEA extension to HTCPCP adapts the operation of certain HTCPCPShow full document text