utf8/nucleus/documentation/devdocs/xmlrpc.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   2 <html xmlns="http://www.w3.org/1999/xhtml">\r
   3 <head>\r
   4         <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
   5         <title>Nucleus - XML-RPC インターフェイス</title>\r
   6         <link rel="stylesheet" type="text/css" href="styles/manual.css" />\r
   7 </head>\r
   8 <body>\r
   9 \r
  10 <div class="heading">\r
  11 XML-RPC インターフェイス\r
  12 </div>\r
  13 \r
  14 <h1>はじめに</h1>\r
  15 \r
  16 <p>\r
  17 <a href="index.html">開発者マニュアルに戻る</a>\r
  18 </p>\r
  19 \r
  20 <p>\r
  21 このドキュメントはNucleusが提供するXML-RPCインターフェイスと、生成される<a href="#errorcodes">エラーメッセージ</a>についての解説です。この仕様は将来変更される可能性があることに注意して下さい。\r
  22 </p>\r
  23 \r
  24 <div class="note">\r
  25 NucleusにおけるXML-RPCインターフェイスのURLは以下のようになります：\r
  26 <br />\r
  27 <b>http://www.yourserver.com/yourpath/nucleus/xmlrpc/server.php</b>\r
  28 \r
  29 </div>\r
  30 \r
  31 <a name="bloggerApi" id="bloggerApi"></a>\r
  32 <h1>Blogger API (XML-RPC)</h1>\r
  33 \r
  34 <p>\r
  35 Nucleusは<a href="http://plant.blogger.com/api/">Blogger API</a>に対応しています。これはBloggerと通信するツールやサービスに対して、Nucleusとも通信できるようにするものです。Nucleusの仕様により、いくつかのパラメータに若干の違いがあります。これについては後述の説明を参照して下さい。呼び出しや応答のメソッドは、もちろん、Bloggerのものと同じ構造になっています。\r
  36 </p>\r
  37 \r
  38 <p>\r
  39 ここに挙げたリストは利用できるメソッドの一覧です。クリックするとさらに詳しい情報を得ることができます（それぞれのリンク先はBlogger APIの仕様書やその<a href="http://groups.yahoo.com/group/bloggerDev">メーリングリスト</a>です）。\r
  40 </p>\r
  41 \r
  42 <ul>\r
  43         <li><b><a href="http://plant.blogger.com/api/xmlrpc_newPost.html">blogger.newPost</a></b></li>\r
  44         <li><b><a href="http://plant.blogger.com/api/xmlrpc_editPost.html">blogger.editPost</a></b></li>\r
  45         <li><b><a href="http://groups.yahoo.com/group/bloggerDev/message/296">blogger.getPost</a></b></li>\r
  46         <li><b><a href="http://groups.yahoo.com/group/bloggerDev/message/147">blogger.deletePost</a></b></li>\r
  47         <li><b><a href="http://plant.blogger.com/api/xmlrpc_getUsersBlogs.html">blogger.getUsersBlogs</a></b></li>\r
  48 \r
  49         <li><b><a href="http://groups.yahoo.com/group/bloggerDev/message/225">blogger.getRecentPosts</a></b></li>\r
  50         <li><b><a href="http://groups.yahoo.com/group/bloggerDev/message/315">blogger.getUserInfo</a></b></li>\r
  51         <li><b><a href="http://plant.blogger.com/api/xmlrpc_getTemplate.html">blogger.getTemplate</a></b></li>\r
  52         <li><b><a href="http://plant.blogger.com/api/xmlrpc_setTemplate.html">blogger.setTemplate</a></b></li>\r
  53 </ul>\r
  54 \r
  55 \r
  56 <p>\r
  57 Nucleusは内部的に異なる実装を用いているため、パラメータの扱いに若干の違いがあります。概説すると：\r
  58 \r
  59 </p>\r
  60 \r
  61 <ul>\r
  62         <li>Appkeyは無視されます。</li>\r
  63         <li>Nucleusの場合は本文のあとにタイトルとカテゴリが続きます。Bloggerでは 'コンテンツ' と呼ばれるは本文だけが存在します。これらの追加されたパーツを利用可能にするため、<tt>&lt;title&gt;</tt>や<tt>&lt;category&gt;</tt>をNucleusに送るコンテンツに含めることができます。これらのタグは getRecentPosts の呼び出しでのみ追加されます。</li>\r
  64         <li>Bloggerで 'templates' と呼ばれているものに相当するのが、Nucleusの 'スキン' です。ひとつのシステムに複数のスキンを設定でき、それぞれのスキンをblogごとに使い分けることができます。メソッド blogger.setTemplate と blogger.getTemplate は、Nucleusのblog設定で選択されているblogのデフォルトスキンに影響します。'main' と 'archiveIndex' の二種類のテンプレートは、Nucleusの 'メインの目次ページ' と '月別アーカイブ一覧ページ' に相当します。（<em>訳注： Blogger の仕様がわからないので、この項不確か</em>)</li>\r
  65 \r
  66         <li>項目 <tt>publish</tt> は、追加した項目がデフォルトでドラフトになるか公開になるかを決める箇所です。<tt>blogger.editPost</tt> を使う場合は、<tt>publish</tt> がドラフトと公開のどちらになっていても無視されます。</li>\r
  67         <li><tt>getUserInfo</tt> を呼び出した場合、返値のうち 'lastname' は空になり、'firstname' にフルネームが入ります。これはNucleusが姓と名を分けない仕様になっていることに由来します。</li>\r
  68 \r
  69         <li>メソッド <tt>getRecentPostst</tt> は <tt>authorName</tt> と <tt>title</tt> を追加パラメータとして返します。Bloggerもまたこれらの値を返します（この仕様は文書化されていないようですが）。</li>\r
  70 </ul>\r
  71 \r
  72 <a name="metaWeblogApi" id="metaWeblogApi"></a>\r
  73 <h1><a name="metaweblog"></a>metaWeblog API</h1>\r
  74 \r
  75 <p>\r
  76 Nucleus v1.1以降、<a href="http://www.xmlrpc.com/metaWeblogApi">metaWeblog API</a>もサポートされました。これはBlogger APIの拡張版です。 \r
  77 </p>\r
  78 \r
  79 <p>\r
  80 Nucleus v2.5では <code>newMediaObject</code> と <code>getRecentPosts</code> の二つのメソッドにも対応しました（これらは最初のmetaWeblog仕様には存在しませんでした）。\r
  81 </p>\r
  82 \r
  83 <p>\r
  84 利用可能なメソッド一覧は以下の通りです（<a href="http://www.xmlrpc.com/metaWeblogApi">specification</a>に詳しい情報があります）：\r
  85 </p>\r
  86 \r
  87 <ul>\r
  88         <li>metaWeblog.newPost</li>\r
  89         <li>metaWeblog.editPost</li>    \r
  90         <li>metaWeblog.getPost</li>     \r
  91         <li>metaWeblog.getCategories</li>       \r
  92         <li>metaWeblog.newMediaObject (v2.5)</li>\r
  93         <li>metaWeblog.getRecentPosts (v2.5)</li>       \r
  94 \r
  95 </ul>\r
  96 \r
  97 <a name="mtApi" id="mtApi"></a>\r
  98 <h1>Movable Type API</h1>\r
  99 \r
 100 <p>v2.5から、Nucleusは<a href="http://www.movabletype.org/docs/mtmanual_programmatic.html">Movable Type API</a>からのメソッドをサポートするようになりました。</p>\r
 101 \r
 102 <p>利用できるメソッドの一覧を以下に示します：</p>\r
 103 \r
 104 <ul>\r
 105         <li>mt.supportedMethods</li>\r
 106 \r
 107         <li>mt.supportedTextFilters</li>\r
 108         <li>mt.publishPost</li>\r
 109         <li>mt.getCategoryList</li>\r
 110         <li>mt.getPostCategories</li>\r
 111         <li>mt.setPostCategories</li>\r
 112         <li>mt.getRecentPostTitles</li>\r
 113 \r
 114         <li>mt.getTrackbackPings</li>\r
 115 </ul>\r
 116 \r
 117 <p>いくつかのノート：</p>\r
 118 \r
 119 <ul>\r
 120         <li>Nucleusはアイテムひとつにつき一つだけカテゴリを設定することができます。これは 'primary' 以外のカテゴリ設定項目はすべて無視されることを意味します。</li>\r
 121         <li>トラックバックはNucleusのコアではサポート対象外です（プラグインの導入によって利用することができるようになります）。このため、<code>mt.getTrackbackPings</code> のデフォルトの返値は空です。</li>\r
 122 \r
 123         <li>Nucleusはテキストフィルタを実装していません。このため、<code>mt.getSupportedTextFilters</code> は空の値を返します。</li>\r
 124 </ul>\r
 125 \r
 126 <h1><a name="errorcodes"></a>エラーコード</h1>\r
 127 \r
 128 <p>\r
 129 以下に示すのは、それぞれのメソッドから得られるエラーの種類です：\r
 130 </p>\r
 131 \r
 132 <table>\r
 133         <tr>\r
 134 \r
 135                 <th>エラーコード</th>\r
 136                 <th>エラーメッセージ</th>\r
 137         </tr>\r
 138         <tr>\r
 139                 <td>801</td>\r
 140                 <td>Login Error <br />\r
 141                 ログインエラー（ユーザ名とパスワードの組み合わせが正しくないと推測されます）</td>\r
 142         </tr>\r
 143 \r
 144         <tr>\r
 145                 <td>802</td>\r
 146                 <td>No Such Blog<br />\r
 147                 指定されたBlogは存在しません</td>\r
 148         </tr>\r
 149         <tr>\r
 150                 <td>803</td>\r
 151                 <td>Not a Team Member<br />\r
 152                 チームに登録されていません</td>\r
 153 \r
 154         </tr>\r
 155         <tr>\r
 156                 <td>804</td>\r
 157                 <td>Cannot add Empty Items<br />\r
 158                 空のアイテムは投稿できません</td>\r
 159         </tr>\r
 160         <tr>\r
 161                 <td>805</td>\r
 162 \r
 163                 <td>Amount parameter must be in range 1..20<br />\r
 164                 パラメータの値は 1..20 の範囲でなければなりません（<i>getRecentItems</i></td>\r
 165         </tr>\r
 166         <tr>\r
 167                 <td>806</td>\r
 168                 <td>No Such Item<br />\r
 169                 指定されたアイテムは存在しません</td>\r
 170         </tr>\r
 171 \r
 172         <tr>\r
 173                 <td>807</td>\r
 174                 <td>Not Allowed to Alter Item<br />\r
 175                 アイテム追加の権限がありません</td>\r
 176         </tr>\r
 177         <tr>\r
 178                 <td>808</td>\r
 179                 <td>Invalid media type<br />\r
 180                 メディアタイプが不正です</td>\r
 181 \r
 182         </tr>   \r
 183         <tr>\r
 184                 <td>809</td>\r
 185                 <td>File is too large<br />\r
 186                 ファイルが大きすぎます（最大のアップロードファイルサイズ）</td>\r
 187         </tr>           \r
 188         <tr>\r
 189                 <td>810</td>\r
 190                 <td>Other error on newMediaObject<br />\r
 191                 newMediaObject で予期せぬエラーが発生しました（何が起きたのかもう少し情報が含まれるでしょう）</td>\r
 192 \r
 193         </tr>\r
 194         <tr>\r
 195                 <td><i>その他のコード &lt; 100</i></td>\r
 196                 <td>Errors encountered by the Useful Inc. XML-RPC implementation<br />\r
 197                 Usefil Inc. XML-RPC の実行でエラーが発生しました</td>\r
 198         </tr>\r
 199         <tr>\r
 200                 <td><i>その他のコード &gt; 100</i></td>\r
 201 \r
 202                 <td>Errors encountered by the XML parser<br />\r
 203                 XML パーサでエラーが発生しました</td>\r
 204         </tr>\r
 205 \r
 206 \r
 207 </table>\r
 208 \r
 209 </body>\r
 210 </html>\r