Hatena::Grouphatenadeveloper

はてなブックマーク REST API

ja/bookmark/apis/rest

はてなブックマーク REST API

はてなブックマーク REST API

はじめに

はてなブックマーク REST API を使うと、はてなブックマークのブックマーク、エントリーなどの情報を取得したり、新規に作成・投稿したりできます。

本ドキュメントに関する注意事項

API の仕様は予告なく変更される可能性があります。

過剰な連続アクセス、 User-Agent を正しく指定しないアクセスなどは予告なしに制限をかける場合があります。

バージョン

2013年8月現在、バージョン1が提供されています。

認証

本 API は OAuth によるユーザー認証に対応しています。OAuth 認証の詳細に関しては、はてなサービスにおける OAuth を参照してください。

提供するフォーマット

JSON 形式をサポートしております。各 API の出力の例をご覧ください。

ブックマーク API

名前 実行する操作
GET /{version}/my/bookmark ブックマーク情報を取得する
POST /{version}/my/bookmark ブックマークを追加または更新する
DELETE /{version}/my/bookmark ブックマークを削除する

OAuth 認証したユーザーのブックマークの情報を取得・操作する API です。

エントリー API

名前 実行する操作
GET /{version}/entry ブックマークされたエントリーの情報を取得する

ブックマークされたエントリーの情報を取得する API です。

タグ API

名前 実行する操作
GET /{version}/my/tags ユーザーのタグの情報を取得する

OAuth 認証したユーザーのタグの情報を取得する API です。

ユーザー情報 API

名前 実行する操作
GET /{version}/my ユーザーの情報を取得する

OAuth 認証したユーザーの情報を取得する API です。