Skip to content
ichigotake edited this page Jan 25, 2015 · 20 revisions

yancha API(仮)仕様

Login(トークンの取得)

GET: /login?nick=yancha_boy&token_only=1
87720937dfd30d0511c44f165e801e99c2fa69b41c665ba55bd8d23cd9c9c76a
*必須 説明 備考
* nick ログイン時のニックネーム
* token_only トークンのみを取得します
callback_url ログイン時のコールバックURLを指定します。コールバックのクエリーにはトークンが付与されています

Post API

発言を投稿するAPI

クライアントは事前にログインしてtokenを取得している必要があります

POST: /api/post
text=ohayou&token=87720937dfd30d0511c44f165e801e99c2fa69b41c665ba55bd8d23cd9c9c76a
*必須 説明 備考
* token ログイン時に取得したトークンを指定します
* text 投稿するメッセージを指定します タグを指定する場合はtextの中に含めて指定

Search API

発言ログを取得するAPI

GET: /api/search?keyword=Hello
[{"created_at_ms":"137067463912417","nickname":"ichigotake","profile_image_url":"http://a0.twimg.com/profile_images/3191665942/7f8b0c7b06522c4b2540a6816e10544c_normal.png","user_key":"twitter:150657117","tags":["PUBLIC"],"created_at_datetime":"2013-06-08 15:57:19","plusplus":"0","text":" Hello Yancha1 #PUBLIC","profile_url":"https://twitter.com/#!/ichigotake","id":"447"}]
説明 デフォルト値 備考
id 指定の発言IDを抽出します カンマ区切りで複数指定可
tag 指定のタグが含まれる発言を抽出します カンマ区切りで複数指定可。複数指定した場合はAND検索
keyword キーワードが含まれる発言を抽出します スペースもしくはカンマ区切りでAND検索
newer より新しい発言を指定件数取得します olderとの同時指定不可
older より過去の発言を指定件数取得します newerとの同時指定不可
time UNIXタイムスタンプで発言の時間範囲を指定します カンマ区切りの第1フィールド以上第2フィールド未満の発言を抽出
older_than_id 指定したPost未満のポストを取得できます。Offsetは無視されます。 ページング処理に利用されています。
limit 取得件数の上限を指定します 20 カンマ区切りの第2フィールドに *offset* を指定可能
order ソート順を指定します。カンマ区切りで複数指定可能 フィールド名の先頭に-(ハイフン)をつけると降順になります
例) -created_at_ms,text
format 返すデータのフォーマットを指定します json "json" or "text"