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

仕様書

意味

[3] Slug: 欄が POST 要求に含まれている場合、その値は作成されるエントリー資源や媒体資源が通常取り出しされる際に使われる URI の一部分としてクライアントが望む値を表します。 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 百分率符号化を施した値とされています。 AtomPub

文脈

[12] AtomPub の要求で使われます。

[13] それ以外でも稀に使われるようです (>>8、>>10)。

処理

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

例

[7] AtomPub より

       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...

関連

[11] フォーム提出など multipart/form-data でファイルを送信する場合には、 Content-Disposition ヘッダーの filename 引数でファイル名が指定されますから、サーバーはそれをヒントに使えます。

[14] ダウンロードのファイル名の指定には、応答の Content-Disposition: ヘッダーの filename 引数や、リンク元の HTML の a 要素の download 属性が使えます。

メモ

[8] Protocol Guide (v3.0) - Google Documents List Data API v3.0 - Google Code ( 版) http://code.google.com/intl/ja-JP/apis/documents/docs/3.0/developers_guide_protocol.html

[9] Developer's Guide: JSON-C / JavaScript - YouTube — Google Developers ( ( 版)) https://developers.google.com/youtube/2.0/developers_guide_jsonc?hl=ja&csw=1

[10] Linked Data Platform 1.0 ( 版) https://dvcs.w3.org/hg/ldpwg/raw-file/default/ldp.html#h-ldpc-post-slug

5.2.3.10 LDP servers may allow clients to suggest the URI for a resource created through POST, using the HTTP Slug header as defined in [RFC5023]. LDP adds no new requirements to this usage, so its presence functions as a client hint to the server providing a desired string to be incorporated into the server's final choice of resource URI.

[15] Web Annotation Protocol () https://w3c.github.io/web-annotation/protocol/wd/#h-suggesting-an-iri-for-an-annotation

The IRI path segment that is appended to the Container IRI for a resource may be suggested by the Annotation Client by using the Slug HTTP header on the request when the resource is created. The server should use this name, so long as it does not already identify an existing resource, but may ignore it and use an automatically assigned name.

[16] OSLC Core Version 3.0. Part 5: Attachments () http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/cs01/part5-attachments/oslc-core-v3.0-cs01-part5-attachments.html

5.4.2 Clients may use the HTTP Slug request header [RFC5023] to suggest a name when creating an attachment. If present, the Slug header should not include a file extension.