Hatena::Grouphatenadeveloper

うごメモはてな情報取得API

ja/ugomemo/apis

うごメモはてな情報取得API

廃止

※これらのAPIは2013年5月31日のうごメモはてなのサービス終了を持って提供を終了します。

APIで取得できる情報について

このAPIでは、自分に紐づく情報に限り、作品・コメント・お気に入り作者・ファンの情報を取得することができます。

すべてのAPIはtokenというクエリパラメータを「認証トークン」として必要とし、取得しようとする情報の所有者と、トークンの値が等しい場合に限りJSONで情報を返します。

自分の認証トークンは http://ugomemo.hatena.ne.jp/my/setting から確認できます。

作品情報取得

http://ugomemo.hatena.ne.jp/${DSiID}@DSi/movie/${FILENAME}.json?token={token}
HTTPメソッドGET

パラメータ

tokenDSi固有のAPI認証トークン

レスポンス

uri作品のURI。
flv_uriFLVファイルのURI。
3gp_uri3GPPファイルのURI。
ppm_uriPPMファイルのURI。
thumbnail_uri64x48、128x96、256x192のサムネイルのURI。
animation_gif_uri128x96、192x144のアニメーションGIFのURI。
title作品のタイトル。
description作品の説明文。
author作者情報。内容はユーザ情報取得APIと同じ。
parent親作品の情報。uriauthorを含む連想配列。uriは親作品のURI、authorは親作品の作者で、ユーザ情報取得APIと同じ。
play_count再生数。
download_countダウンロード数。
star_countスター数
unique_star_countスターをつけたユーザ数。
comment_countコメント数。
region作品のリージョン番号。
created_on作品の投稿時間。epochを持つ連想配列。

エラー

  • 作品が存在しない場合は404 Not Foundになる
  • 認証トークンがない場合は400 Bad Requestになる
  • 認証トークンが不正の場合は403 Forbiddenになる

ユーザの作品一覧取得

http://ugomemo.hatena.ne.jp/${DSiID}@DSi/movies.json?token={token}
HTTPメソッドGET

ページング有り。1ページ当たり30件。

パラメータ

tokenDSi固有のAPI認証トークン
page取得するページ数。デフォルトは1

レスポンス

count作品総数
pagerpage現在のページ。
total_pages総ページ数
per_page1ページあたりの作品数。今は固定で30
prev_uri前のページのURI。前がないときはnull
next_uri次のページのURI。次がないときはnull
movies作品情報の配列。

エラー

  • ユーザが存在しない場合は404 Not Foundになる
  • /${はてなID}/movie.jsonにアクセスすると400 Bad Requestになる (必ずDSi IDでアクセスしなければならない)
  • 認証トークンがない場合は400 Bad Requestになる
  • 認証トークンが不正の場合は403 Forbiddenになる

お気に入り作者一覧

http://ugomemo.hatena.ne.jp/${DSiID}@DSi/favorite_authors.json?token={token}
HTTPメソッドGET

ページング有り。1ページ当たり30件。

パラメータ

tokenDSi固有のAPI認証トークン
page取得するページ数。デフォルトは1

レスポンス

countお気に入り作者総数
pagerpage現在のページ。
total_pages総ページ数
per_page1ページあたりのユーザ数。今は固定で30
prev_uri前のページのURI。前がないときはnull
next_uri次のページのURI。次がないときはnull
authorsユーザ情報の配列。

エラー

  • ユーザが存在しない場合は404 Not Foundになる。
  • 認証トークンがない場合は400 Bad Requestになる
  • 認証トークンが不正の場合は403 Forbiddenになる

ファン一覧

http://ugomemo.hatena.ne.jp/${DSiID}@ID/fans.json?token={token}
HTTPメソッドGET

ページング有り。1ページ当たり30件。

パラメータ

tokenDSi固有のAPI認証トークン
page取得するページ数。デフォルトは1

レスポンス

countファン総数
pagerpage現在のページ。
total_pages総ページ数
per_page1ページあたりのユーザ数。今は固定で30
prev_uri前のページのURI。前がないときはnull
next_uri次のページのURI。次がないときはnull
authorsユーザ情報の配列。

エラー

  • ユーザが存在しない場合は404 Not Foundになる。
  • 認証トークンがない場合は400 Bad Requestになる
  • 認証トークンが不正の場合は403 Forbiddenになる

作品のコメント一覧

自分の作品についたコメントの一覧を取得できます。

http://ugomemo.hatena.ne.jp/${DSiID}@DSi/movie.comment/${FILENAME}.json?token={token}
HTTPメソッドGET

ページング有り。1ページ当たり30件。投稿日時で昇順 (古い順)。

パラメータ

tokenDSi固有のAPI認証トークン
page取得するページ数。デフォルトは1

レスポンス

countコメント総数
pagerpage現在のページ。
total_pages総ページ数
per_page1ページあたりのコメント数。今は固定で30
prev_uri前のページのURI。前がないときはnull
next_uri次のページのURI。次がないときはnull
commentsコメント情報の配列。コメント情報は後述する。

コメント情報は以下のキーを含む連想配列。

authorコメントの投稿者。内容はユーザ情報取得APIと同じ。
bodyテキストコメントの本文。ちょっとメモコメントのときは存在しない。
thumbnailちょっとメモコメントの画像。64x48と128x96、256x192のサイズの画像のURIを含む。テキストコメントのときは存在しない。
created_onepochを持つ連想配列。コメントの投稿時間。

エラー

  • 作品が存在しない場合は404 Not Foundになる。
  • 認証トークンがない場合は400 Bad Requestになる
  • 認証トークンが不正の場合は403 Forbiddenになる

関連ドキュメント

はてなスター取得 API
作品やコメントに付いたスターの情報を取得できます。
はてなメッセージ送信箱・受信箱 API
うごレターの一覧と内容を取得できます。
うごメモはてなの情報取得APIを公開しました (Hatena Developer Blog)
はてなエンジニアによる紹介記事です。サンプルコードも掲載しています。

変更履歴

  • 2013年5月31日 廃止
  • 2013年5月7日 自分に紐づく情報のみの取得に限り再提供
  • 2013年4月12日 提供を一時停止
  • 2013年4月11日 公開