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
Show full document text