PING.BLOGGERS.JP API

ping.bloggers.jp API

ping.bloggers.jp では、通常の ping server としての機能と共に、いくつかの便利な機能を提供しています。

ping の受信

URL: http://ping.bloggers.jp/rpc/< br/> XML-RPC/weblogUpdates.ping による ping を受信します。

更新情報 (changes.xml)

URL: http://ping.bloggers.jp/changes.xml< br/> 受信した ping を changes.xml 形式で公開しています。

更新情報 (index.rdf)

URL: http://ping.bloggers.jp/index.rdf< br/> 受信した ping を RSS/RDF 形式で公開しています。

changes.xml, index.rdf 形式の更新情報の取得のとき、以下の設定を加えて、情報を制御可能です。

last=N
更新情報の提供範囲を現在から N 秒間に制限します。設定されていない場合は、3600秒 (一時間) になります。高頻度での取得を行うときには、なるべく設定してください。

filter=www.example.com
更新情報のうち、URL に www.example.com を含むものだけを表示します。filter=^www.example.comのように、先頭に ^ を付けると、含まれないものだけを表示します。filter=www.example.com+www.example.org や、filter=^www.example.com*^www.example.org のようにして * で AND検索、+ で OR検索も可能です。

例: 過去5分間の更新情報だけ取得する http://ping.bloggers.jp/changes.xml?last=300

特定のウェブログの更新時刻

URL: http://ping.bloggers.jp/update?format=xml&url=http://www.example.com/
特定のウェブログからの更新 ping が最後に通知された時刻を取得できます。format=xml が指定されている場合、もしくは無指定の場合、XML で以下のような形式で出力されます。

<?xml version="1.0" encoding="utf-8"?>
<result>
  <weblog>
    <title>dh's memoranda</title>
    <link>http://uva.jp/dh/mt/</link>
    <date>2004-10-03T18:41:18+09:00</date>
    <epoch>1096796478</epoch>
    <elapsed>5183</elapsed>
  </weblog>
</result>

epoch は更新時刻の epoch time、elapsed は更新時刻からリクエスト時までの経過秒数です。URL に該当するウェブログが複数見付かった場合は、それぞれについて結果を返します。ウェブログが10以上見付かった場合、もしくは見付からなかった場合、見つかったが一定期間更新がない場合、それぞれについてエラーを返します。

format=simple を指定すると、elapsed の値のみを出力します。simple が指定されている場合、複数の結果が見付かったとき、もしくはエラーの場合、-1を出力します。