Weblogs.Com XML-RPC interface 日本語訳

本ドキュメントは、UserLand Software, Inc. が公開している 『Weblogs.Com XML-RPC interface』 を futomi が日本語化したものです。みなさまの理解に役立てれば幸いです。なお、緑色で記載された文章は、futomi が注釈として加筆したものです。また、一部、直訳ではなく、意訳した部分がございます。原文と表現が異なることがございますので、ご了承ください。

注意: この日本語訳は、futomi が理解を深めるために、自分なりに日本語化したものです。本日本語訳には、翻訳上の誤りがある可能性があります。したがって、内容について一切保証をするものではありません。正確さを求める場合には、必ず原文を参照してください。当方は、この文書によって利用者が被るいかなる損害の責任を負いません。

もし誤りなどを見つけたら、こちらからご連絡いただければ幸いです。


Weblogs.Com XML-RPC interface

Sun, Sep 30, 2001; by Dave Winer.

Weblogs.Com って何ですか?

Weblogs.Com は、ニュース指向のウェブサイトの更新を追跡するウェブアプリケーションです。Weblogs.Com は 1999 年暮れに開始されました。その時、XML-RPC はかなり若く、そんなに多くのウェブログもありませんでした。今日、XML-RPC は広く展開され、ウェブログコミュニティーは数百のサイトから何千という数にまで成長してきました。

この成長に備えて、我々はウェブログの更新を追跡するための新しいメカニズムを設計し展開してきました。その変遷はここに漏れなく説明されています。このページでは、更新用の XML-RPC メカニズムを説明します。

weblogUpdates.ping (weblogname, weblogurl, changesurl=weblogurl, categoryname="none") returns struct

ウェブログが更新されたことを Weblogs.Com に通知するには、rpc.weblogs.com の port 80, パス /RPC2 にある weblogUpdates.ping を呼び出してください。

それは 2 つのパラメータを取ります。それらはともに文字列で、それぞれには 2 つのオプションパラメータがあり、それらも文字列です。一つ目は weblog の名前で、2 つ目はその URL です。3 つ目の changesurl は、更新をチェックしたページの URL です。4 つ目の categoryname は、ping のカテゴリー名で、weblogs.com インタフェースに、European weblogs とかそういったものの RSS フィードを追跡するために使うことができます。

我々は、ウェブログが更新されれば、調査のためにそのウェブログを読みに行きます。それゆえに、貴方が weblogUpdates.ping を呼び出すときには、ウェブログがすでに更新されていなければいけません

それは、成功または失敗を指し示す sturct を返します。その struct は flerror と message という 2 つの要素を持ちます。flerror が false なら、正常に完了したことを表します。もしflerror が true なら、messege には失敗の理由が英語で記述されています。

もしコールが成功なら、ウェブログは changes.xml に現れるでしょう。

メモ

10/1/01: 一つの SOAP 1.1 インタフェースと 2 つの HTTP-GET インタフェースがあります。一方は一つの URL を取り、もう一方は 2 つの URL を取ります

リクエストとレスポンス

以下は、コールとその応答の例です。

POST /RPC2 HTTP/1.0
User-Agent: Radio UserLand/7.1b7 (WinNT)
Host: rpc.weblogs.com
Content-Type: text/xml
Content-length: 250

<?xml version="1.0"?>
<methodCall>

  <methodName>weblogUpdates.ping</methodName>
  <params>
  <param>
  <value>Scripting News</value>
  </param>
  <param>
  <value>http://www.scripting.com/</value>
  </param>
  </params>
  </methodCall>



HTTP/1.1 200 OK
Connection: close
Content-Length: 333
Content-Type: text/xml
Date: Sun, 30 Sep 2001 20:02:30 GMT
Server: UserLand Frontier/7.0.1-WinNT

<?xml version="1.0"?>
<methodResponse>
  <params>
  <param>
  <value>
  <struct>
  <member>
  <name>flerror</name>
  <value>
  <boolean>0</boolean>
  </value>
  </member>
  <member>
  <name>message</name>
  <value>Thanks for the ping.</value>
  </member>
  </struct>
  </value>
  </param>
  </params>
  </methodResponse>