技術的情報 (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