[1] [DFN[[CODE(HTTP)@en[[[Slug]]:]] [[頭欄]]]]は、
作成される[[資源]]の [[URL]] の決定時のヒントを表します。

:[[欄名]]:[CODE(HTTP)@en[[[Slug]]]]
:[[欄本体]]:[[百分率符号化]]された[[文字列]]
:種類:[[実体頭欄]]

[2] 仕様書:
-[CITE@en[RFC 5023 - The Atom Publishing Protocol]] 
-- <http://tools.ietf.org/html/rfc5023#section-9.7>
-- <http://tools.ietf.org/html/rfc5023#section-16.3>

* 意味

[3] [CODE(HTTP)@en[[[Slug]]:]] [[欄]]が [CODE(HTTP)@en[[[POST]]]]
[[要求]]に含まれている場合、その値は作成される[[エントリー資源]]や[[媒体資源]]が通常[[取り出し]]される際に使われる
[[URI]] の一部分として[[クライアント]]が望む値を表します。
[SRC@en[[[AtomPub]]]]

* 構文

[5] [[AtomPub]] より:

>
       LWS      = <defined in Section 2.2 of [RFC2616]>
       slugtext = %x20-7E | LWS
       Slug     = "Slug" ":" *slugtext


[6] 値は [[RFC 3629]] [[UTF-8]] で[[符号化]]し、 [[RFC 3986]] [[百分率符号化]]を施した値とされています。
[SRC@en[[[AtomPub]]]]

* 処理モデル

[4] [[鯖]]は新しく作成する[[資源]]の[[成員URI]] を作成する時にこの[[欄]]の値を使って[['''構いません''']]。
例えば、その値の一部または全部を [[URI]] の最後の [[segment]] に使うことができます。
[[鯖]]は [CODE(XMLe)@en[atom:[[id]]]] や[[媒体リンク・エントリー]]の [CODE(XML)@en[[[title]]]]
にも使って[['''構いません''']]。[[鯖]]はこの[[欄]]を無視しても[['''構いません''']]。
値の一部の[[文字]]を置き換えるなど変形させても[['''構いません''']]。
[SRC@en[[[AtomPub]]]]

* 例

[7] [[AtomPub]] より

[PRE(HTTP example code)[
       POST /myblog/entries HTTP/1.1
       Host: example.org
       Content-Type: image/png
       Slug: The Beach at S%C3%A8te
       Authorization: Basic ZGFmZnk6c2VjZXJldA==
       Content-Length: nnn

       ...binary data...
]PRE]



[8] [CITE[Protocol Guide (v3.0) - Google Documents List Data API v3.0 - Google Code]]
([TIME[2009-10-10 03:25:53 +09:00]] 版)
<http://code.google.com/intl/ja-JP/apis/documents/docs/3.0/developers_guide_protocol.html>

[9] [CITE@en[Developer's Guide: JSON-C / JavaScript - YouTube — Google Developers]]
( ([TIME[2013-09-12 18:53:20 +09:00]] 版))
<https://developers.google.com/youtube/2.0/developers_guide_jsonc?hl=ja&csw=1>