Notice (8): Undefined index: HTTP_ACCEPT_LANGUAGE [APP/Controller/AppController.php, line 114]
技術的情報 (For Developer) :: Share Books

技術的情報 (For Developer)

1511 View :: 2013-01-17 11:26:22

Share Booksはweb開発者に対してノートデータの取得や、ユーザーデータの取得などの機能をAPIとして提供します。

現在提供しているAPIは下記の通りです。

ユーザーIDからユーザーデータを取得する

JSON:
http://sharebooks.us/api/get_user/[user_id].json
HTML(返り値の確認用):
http://sharebooks.us/api/get_user/[user_id].html
[user_id]:ユーザーID
ここURLにリクエストを送るとユーザーIDとユーザーIDに紐づけられている名前、Facebook id、Twitter idが取得することができます。
取得できない場合は配列でエラーコードとエラー内容が返されます。

ユーザーIDからそのユーザーのノートを取得する

JSON:
http://sharebooks.us/api/get_user_note/[user_id].json
HTML(返り値の確認用):
http://sharebooks.us/api/get_user_note/[user_id].html
[user_id]:ユーザーID
ここURLにリクエストを送るとノートのIDとID hash、タイトル、本文、ショートリンク、リンク、作成日時、更新日時を取得することができます。
取得できなかった場合は配列でエラーコードとエラー内容が返されます。

オプションでノートのソートを指定することができます。
JSON:
http://sharebooks.us/api/get_user_note/[user_id]/[sort].json
HTML(返り値の確認用):
http://sharebooks.us/api/get_user_note/[user_id]/[sort].html
[user_id]:ユーザーID
[sort]:ソート(並び順)
ソートの値には”ASC”(最終更新日昇順)と"DESC"(最終更新日降順)、”RAND”(ランダム)が指定できます。

ノートのID hashからそのノートの情報を取得する

JSON:
http://sharebooks.us/api/get_note/[note_id_hash].json
HTML(返り値の確認用):
http://sharebooks.us/api/get_note/[note_id_hash].html
ここURLにリクエストを送るとノートのユーザーIDとID hash、タイトル、本文、ショートリンク、リンク、作成日時、更新日時を取得することができます。
取得できなかった場合は配列でエラーコードとエラー内容が返されます。

外部サイトからノートを書くページへリンクする場合

外部サイトからShareBooksでシェアするためのリンクを作成できます。

http://sharebooks.us/notes/write/?tag=[tag]&tl=[title]&summery=[body]

[tag]:タグ
[title]:タイトル
[body]:本文
文字は下記のようにURLエンコードする必要があります。
http://sharebooks.us/notes/write/?tag=%E3%82%BF%E3%82%B0&tl=%E3%82%BF%E3%82%A4%E3%83%88%E3%83%AB&summery=%E6%9C%AC%E6%96%87

Written by Share Books Admin

このページのURL:

ShareBooksからのお知らせ
ログイン|使い方|ノートを書く
最近更新されたノート一覧|技術的情報 (For Developer)