[WordPress] Jetpack の JSON API を使ってみる

Qiita Web API Advent Calendar 2015 21日目と、Qiita プロ生ちゃん Advent Calendar 2015 21日目(穴埋め)の投稿です。

Jetpack for WordPress の JSON API

WordPress 社公式の多機能プラグインの Jetpack の機能のひとつに、JSON API があります。有効にすると、OAuth2 による認証および WordPress.com REST API により、あなたの WordPress (Blog) の操作や情報取得ができます。

多機能な API で、WordPress と連携する Web サービスやクライアントアプリを作るときに使えるでしょう。たとえば、WordPress 標準では用意されていないカテゴリーとタグ両方を指定した投稿の取得もできます。

余談です。これまで無効にしていたのですが、すぱこーの RSS フィード を公開するために利用しました。この程度であれば WordPress のコードを改変や、プラグインで対応できると思いますが、WordPress とは独立して Web サービスを作るほうが手軽と思ったので。JSON API から情報を取得した後の話は、[ASP.NET MVC] さくっと RSS フィードを出力する に書いています。

機能の有効化

Jetpack の JSON API の機能を有効化しましょう。これで、あなたの WordPress (Blog) 情報にアクセスする API ができました。

Jetpack JSON API

サイト情報の取得

サイト (Blog) の情報を取得してみます。API のエンドポイントは、次の URL です。GET メソッドです。

そう、https://public-api.wordpress.com/ を通して、あなたのサイトの情報が取得できるようになっています。

$site は、Blog のドメインまたは サイトの ID(数字)です。プロ生であれば、次のようになります。

  • https://public-api.wordpress.com/rest/v1.1/sites/pronama.azurewebsites.net/
  • https://public-api.wordpress.com/rest/v1.1/sites/90668331/

ID(数字)は、Jetpack の管理画面にある「サイト統計情報」から、「WordPress.com で詳細な統計情報」へアクセスしたときの URL に含まれています。

ドメインでアクセスできない場合は、Jetpack の連携を一度解除し、再度連携するとうまくいくようです(プロ生もそうでした)。

上記のアクセス結果は、次の通りです。

投稿情報の取得

投稿した情報を取得してみます。いずれも GET メソッドです。

一覧の取得であれば、次のようにカテゴリーやタグによる絞り込みや、offset/number パラメーターで取得する位置と件数も指定できます。その他、指定できるパラメーターはたくさんあります。詳しくは、REST API Resources を参照してくだしあ。

https://public-api.wordpress.com/rest/v1.1/sites/pronama.azurewebsites.net/posts/?category=web-comic&tag=spaco&offset=0&number=10

取得できる投稿の情報は、いろいろあります。普通に Blog を閲覧しているだけではわからない情報も含まれています。以下は、https://public-api.wordpress.com/rest/v1.1/sites/pronama.azurewebsites.net/posts/?category=web-comic&tag=spaco&offset=0&number=1 の結果です。

投稿の情報を取得して何かするだけのサービスであれば、これらの情報で十分使えそうですね。実際、Web コミック「すぱこー」のコンテンツのみをまとめたフィードの作成は、上記 API のみ使っています。

その他の API

API でできることはまだまだたくさんあります。今回は取得のみでしたが、操作も可能です。また、API は次のカテゴリーに分類されています。今回 紹介したのは、Sites と Posts のひとつにすぎません。

  • Users
  • Sites
  • Posts
  • Comments
  • Taxonomy
  • Follow
  • Sharing
  • Freshly Pressed
  • Notifications
  • Insights
  • Reader
  • Stats
  • Media
  • Menus
  • Batch
  • Videos

詳しくは、REST API Resources を参照してください。