技術的情報 (For Developer)
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
このページのURL: