TwitterAPIのListsAPI

まだDraftらしいので（他のAPIと違って、http://api.twitter.com/〜になってるものはDraftの模様）
将来的にはURIは変わるはず
とりあえずざっと書き出す
とりあえずGET list membersまで
あとで詳細書き足す

• create,update,deleteはまだ未検証。getは叩いてる
• 認証されてれば他人のも実行可能なのか？多分ないと思うけど
• API制限falseのものが多い。制限なしなのかも。あとで確認する

http://apiwiki.twitter.com/Twitter-API-Documentation より

• List Methods
  • POST lists (create)
    リストの作成
    • URL：http://api.twitter.com/1/user/lists.format
    • ※作成できるのは1ユーザにつき20リストまで
    • xml, json
  • POST lists id (update)
    リストの更新
    • URL：http://api.twitter.com/1/user/lists/id.format
    • xml, json
  • GET lists (index)
    ユーザが作成したリストの一覧を返す
    プライベートモードのリストは認証ユーザが呼び出したときだけ参照可能
    • URL：http://api.twitter.com/1/user/lists.format
    • xml, json
  • GET list id (show)
    • URL：http://api.twitter.com/1/user/lists/id.format
      指定されたidのリスト情報を返す。id,name,登録者件数,購読者数,URI等
    • xml, json
  • DELETE list id (destroy)
    指定したリストを削除する。実行可能なのは認証ユーザのみ
    • URL：http://api.twitter.com/1/user/lists/id.format
    • xml, json
  • GET list statuses
    指定されたリストに含まれているメンバーのTweetをTLで表示
    • URL：http://api.twitter.com/1/user/lists/list_id/statuses.format
    • xml, json, atom
  • GET list memberships
    指定されたユーザが登録されているリストの一覧を返す
    • URL：http://api.twitter.com/1/user/lists/memberships.format
    • xml, json
    • 1回に返すのは20リストまで。cursorを指定することで何ページ目から取得するか指定できる
  • GET list subscriptions
    指定したユーザが購読しているリストの一覧を返す
    #この場合、指定ユーザが作成したリストは含まれない。followしたもののみ
    • URL：http://api.twitter.com/1/user/lists/subscriptions.format
    • xml, json
    • API制限対象
• List Members Methods
  • GET list members
    指定したリストのメンバー情報を返す。主にプロフィールと最新Tweet
    #他のgetとどう違うのか要確認。似てるような違うような
    • URL：http://api.twitter.com/1/user/list_id/members.format
    • xml, json
    • API制限対象
  • POST list members
  • DELETE list members
  • GET list members id
    指定したリストのメンバーの中で、指定したidのユーザ情報を返す
    • URL：http://api.twitter.com/1/user/list_id/members/id.format
    • API制限対象
    • id=スクリーンネームではなく数値のid
• List Subscribers Methods
  • GET list subscribers
    指定したユーザのリストを購読しているユーザ一覧を返す
    • URL：http://api.twitter.com/1/user/list_id/subscribers.format
    • API制限対象
    • 「自分が購読しているリストについて、同じく購読しているユーザ一覧を返す」のほうがわかりがよいか。
      たとえば http://api.twitter.com/1/jigoma/manzai/subscribers.xml
  • POST list subscribers
  • DELETE list subscribers
  • GET list subscribers id
    指定したユーザのリストを購読しているユーザについての情報を返す
    • URL：http://api.twitter.com/1/user/list_id/subscribers/:id.format
      原文ではidの前にコロンついてるけど外さないと通らない。
      この記法については、私がAPI記述の仕様をまだよく知らないだけで普通なのかも
      http://api.twitter.com/1/user/list_id/subscribers/id.format →これは通る
    • id=スクリーンネームではなく数値のid
    • API制限対象