[1]

サービス文書Service Document
作業空間として群化された、1つ以上の集成の所在と能力を説明する文書。

[2] 仕様書:

[3] サービス文書は資源の作成や編集の処理を始めるために使います。 AtomPub

[4] サービス文書は集成が受け入れる媒体型や分類を示すことができます。 AtomPub

[6] サービス文書をどう発見するかは AtomPub では定義されていません。 AtomPub

媒体型

[7] サービス文書は媒体型 application/atomsvc+xml で識別されます。 AtomPub

application/atomsvc+xml 媒体型

[13] 媒体型 application/atomsvc+xml は、 XML 1.0 で直列化された AtomPub サービス文書を表します。 AtomPub

[14] 仕様書: RFC 5023 - The Atom Publishing Protocol ( 版) http://tools.ietf.org/html/rfc5023#section-16.2

引数

[15] charset: application/xml と同じ (省略可能)。 AtomPub

拡張子

[10] .atomsvc。 AtomPub

素片識別子

[11] 素片識別子については application/xml と同じです。 AtomPub

Macintosh ファイル型符号

[12] TEXT。 AtomPub

文書要素

[9] サービス文書の根要素は app:service 要素です。 AtomPub

取り出し

[5] クライアントがサービス文書の URI について GET 要求を送信すると、鯖は応答でサービス文書を返します。 このサービス文書の内容は、認証等クライアントの要求に応じて変化し得ます。

RFC 5023 - The Atom Publishing Protocol ( 版) http://tools.ietf.org/html/rfc5023#section-5.1

例

[8] 

   <?xml version="1.0" encoding='utf-8'?>
   <service xmlns="http://www.w3.org/2007/app"
            xmlns:atom="http://www.w3.org/2005/Atom">
     <workspace>
       atom:titleMain Site</atom:title>
       <collection
           href="http://example.org/blog/main" >
         atom:titleMy Blog Entries</atom:title>
         <categories
            href="http://example.com/cats/forMain.cats" />
       </collection>
       <collection
           href="http://example.org/blog/pic" >
         atom:titlePictures</atom:title>
         <accept>image/png</accept>
         <accept>image/jpeg</accept>
         <accept>image/gif</accept>
       </collection>
     </workspace>
     <workspace>
       atom:titleSidebar Blog</atom:title>
       <collection
           href="http://example.org/sidebar/list" >
         atom:titleRemaindered Links</atom:title>
         <accept>application/atom+xml;type=entry</accept>
         <categories fixed="yes">
           atom:category
             scheme="http://example.org/extra-cats/"
             term="joke" />
           atom:category
             scheme="http://example.org/extra-cats/"
             term="serious" />
         </categories>
       </collection>
     </workspace>
   </service>

AtomPub より