[1] [DFN[[CODE(MIME)@en[[[message/coffeepot]]]]]] は、 [[HTCPCP]]
における[[珈琲ポット]]への命令を表す [[MIME型]]です。同様に
[DFN[[CODE(MIME)@en[[[message/teapot]]]]]] は、 [[HTCPCP-TEA]]
における[[茶ポット]]への命令を表す [[MIME型]]です。

* 仕様書

[REFS[
- [9] [CITE@en[RFC 2324 - Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0)]] ([TIME[2014-10-06 15:21:16 +09:00]] 版) <http://tools.ietf.org/html/rfc2324#section-4>
- [4] [CITE[RFC Errata Report]] ([TIME[2014-11-14 21:10:39 +09:00]] 版) <http://www.rfc-editor.org/errata_search.php?rfc=2324>
- [11] [CITE@en[RFC 7168 - The Hyper Text Coffee Pot Control Protocol for Tea Efflux Appliances (HTCPCP-TEA)]] ([TIME[2014-10-12 17:41:43 +09:00]] 版) <http://tools.ietf.org/html/rfc7168#section-2.1.2>
- [14] [CITE@en[RFC 7168 - The Hyper Text Coffee Pot Control Protocol for Tea Efflux Appliances (HTCPCP-TEA)]] ([TIME[2014-10-12 17:41:43 +09:00]] 版) <http://tools.ietf.org/html/rfc7168#section-3>
- [5] [CITE@en[RFC 7168 - The Hyper Text Coffee Pot Control Protocol for Tea Efflux Appliances (HTCPCP-TEA)]]
( ([TIME[2014-04-02 07:55:01 +09:00]] 版))
<http://tools.ietf.org/html/rfc7168#page-4>
]REFS]

* 構文

[8] 値は [CODE(HTTP)@en[[[start]]]] と [CODE(HTTP)@en[[[stop]]]] のいずれかです。
[[大文字・小文字不区別]]です。 [SRC[>>9]]

;; [10] その意味は明記されていません。

;;
[3] 将来の拡張を考えると、
[FIG[
- [CODE(ABNF)[coffee-message-body =/ http.[[token]]]] 
]FIG]
とみなした方がいいと思われます。それから、
実装者の独自拡張の場合は例によって [CODE(HTTP)[[[x-]]]] 
接頭辞の規則を採用するべきでしょう。

* 文脈

[7] [[RFC 2324]] によれば、 [[HTCPCP]] の 
[CODE(HTTP)[[[BREW]]]], [CODE(HTTP)[[[POST]]]] 両 method 
を使用する時にはその[[実体]]の[[媒体型]]は 
[CODE@en[[[message/coffeepot]]]] で[['''なければなりません''']] [SRC[>>9]]。

[15] [[HTCPCP-TEA]] では[[珈琲ポット]]でなく[[茶ポット]]への命令の時は
[CODE(MIME)@en[[[message/teapot]]]] を使わなければ[['''ならない''']] [SRC[>>11]]
としています。構文自体は同じようです [SRC[>>11]]。

[16] [[茶]]と[[珈琲]]の両方を提供できる[[鯖]]でも [[MIME型]]が違うので区別できます [SRC[>>11]]。

* 処理モデル

[12] [[HTCPCP]] では値の意味と処理手順は明記されていません。

[13] [[HTCPCP-TEA]] ではより詳しく規定されています [SRC[>>11]]。

* MIME 型

[6] [[RFC 2324]] 2.1.1 は [DFN[[CODE(MIME)@en[[[application/coffee-pot-command]]]]]]
としていますが、 [[RFC 2324]] 4 は [DFN[[CODE(MIME)@en[[[message/coffeepot]]]]]]
としており、[[正誤表]]は後者とするべきと述べています [SRC[>>4]]。

[2] 後者の媒体型の書式が定義されているのに前者はされていないこと、それに後者が MUST ではずせない要求であることから、おそらく後者が正しいのだと思われます。