［Twitter]Twitter API メソッド一覧表(かきかけ)
Status Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| public_timeline | Returns the 20 most recent statuses from non-protected users who have set a custom user icon. Does not require authentication. Note that the public timeline is cached for 60 seconds so requesting it more often than that is a waste of resources. | http://twitter.com/statuses/public_timeline.format | xml, json, rss, atom | GET | Not applicable | |
| friends_timeline | Returns the 20 most recent statuses posted by the authenticating user and that user's friends. This is the equivalent of /home on the Web. | http://twitter.com/statuses/friends_timeline.format | xml, json, rss, atom | GET | 1 per request | since, since_id, count, page |
| user_timeline | Returns the 20 most recent statuses posted from the authenticating user. It's also possible to request another user's timeline via the id parameter below. This is the equivalent of the Web /archive page for your own user, or the profile page for a third party. | http://twitter.com/statuses/user_timeline.format | xml, json, rss, atom | GET | id, count, since, since_id, page | |
| show | Returns a single status, specified by the id parameter below. The status's author will be returned inline. | http://twitter.com/statuses/show/id.format | xml, json | GET | id | |
| update | Updates the authenticating user's status. Requires the status parameter specified below. Request must be a POST. | http://twitter.com/statuses/update.format | xml, json. Returns the posted status in requested format when successful. | POST | status, in_reply_to_status_id | |
| replies | Returns the 20 most recent @replies (status updates prefixed with @username) for the authenticating user. | http://twitter.com/statuses/replies.format | xml, json, rss, atom | GET | page, since, since_id | |
| destroy | Destroys the status specified by the required ID parameter. The authenticating user must be the author of the specified status. | http://twitter.com/statuses/destroy/id.format | xml, json | POST, DELETE | id |
User Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| friends | Returns up to 100 of the authenticating user's friends who have most recently updated, each with current status inline. It's also possible to request another user's recent friends list via the id parameter below. | http://twitter.com/statuses/friends.format | xml, json | GET | id, page, since | |
| followers | Returns the authenticating user's followers, each with current status inline. They are ordered by the order in which they joined Twitter (this is going to be changed). | http://twitter.com/statuses/followers.format | xml, json | GET | id, page | |
| show | Returns extended information of a given user, specified by ID or screen name as per the required id parameter below. This information includes design settings, so third party developers can theme their widgets according to a given user's preferences. You must be properly authenticated to request the page of a protected user. | http://twitter.com/users/show/id.format | xml, json | GET | One of the following is required: | id, email |
Direct Message Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| direct_messages | Returns a list of the 20 most recent direct messages sent to the authenticating user. The XML and JSON versions include detailed information about the sending and recipient users. | http://twitter.com/direct_messages.format | xml, json, rss, atom | GET | since, since_id, page | |
| sent | Returns a list of the 20 most recent direct messages sent by the authenticating user. The XML and JSON versions include detailed information about the sending and recipient users. | http://twitter.com/direct_messages/sent.format | xml, json | GET | since, since_id, page | |
| new | Sends a new direct message to the specified user from the authenticating user. Requires both the user and text parameters below. Request must be a POST. Returns the sent message in the requested format when successful. | http://twitter.com/direct_messages/new.format | xml, json | POST | user, text | |
| destroy | Destroys the direct message specified in the required ID parameter. The authenticating user must be the recipient of the specified direct message. | http://twitter.com/direct_messages/destroy/id.format | xml, json | POST, DELETE | id |
Friendship Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| create | Befriends the user specified in the ID parameter as the authenticating user. Returns the befriended user in the requested format when successful. Returns a string describing the failure condition when unsuccessful. | http://twitter.com/friendships/create/id.format | xml, json | POST | id, follow | |
| destroy | Discontinues friendship with the user specified in the ID parameter as the authenticating user. Returns the un-friended user in the requested format when successful. Returns a string describing the failure condition when unsuccessful. | http://twitter.com/friendships/destroy/id.format | xml, json | POST, DELETE | id | |
| exists | Tests if a friendship exists between two users. | http://twitter.com/friendships/exists.format | xml, json | GET | user_a, user_b |
Account Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| verify_credentials | Returns an HTTP 200 OK response code and a format-specific response if authentication was successful. Use this method to test if supplied user credentials are valid with minimal overhead. | http://twitter.com/account/verify_credentials.format | xml, json | GET | ||
| end_session | Ends the session of the authenticating user, returning a null cookie. Use this method to sign users out of client-facing applications like widgets. | http://twitter.com/account/end_session | xml, json | POST | ||
| update_location | Updates the location attribute of the authenticating user, as displayed on the side of their profile and returned in various API methods. Works as either a POST or a GET. | http://twitter.com/account/update_location.format | xml, json | POST | location | |
| update_delivery_device | Sets which device Twitter delivers updates to for the authenticating user. Sending none as the device parameter will disable IM or SMS updates. | http://twitter.com/account/update_delivery_device.format | xml, json | POST | device | |
| rate_limit_status | Returns the remaining number of API requests available to the authenticating user before the API limit is reached for the current hour. Calls to rate_limit_status require authentication, but will not count against the rate limit. | http://twitter.com/account/rate_limit_status.format | xml, json | GET |
Favorite Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| favorites | Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format. | http://twitter.com/favorites.format | xml, json, rss, atom | GET | id, page | |
| create | Favorites the status specified in the ID parameter as the authenticating user. Returns the favorite status when successful. | http://twitter.com/favorites/create/id.format | xml, json | POST | id | |
| destroy | Un-favorites the status specified in the ID parameter as the authenticating user. Returns the un-favorited status in the requested format when successful. | http://twitter.com/favorites/destroy/id.format | xml, json | POST, DELETE | id |
Notification Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| follow | Enables notifications for updates from the specified user to the authenticating user. Returns the specified user when successful. | URL:http://twitter.com/notifications/follow/id.format | xml, json | POST | id | |
| leave | Disables notifications for updates from the specified user to the authenticating user. Returns the specified user when successful. | http://twitter.com/notifications/leave/id.format | xml, json | POST | id |
Block Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| create | Blocks the user specified in the ID parameter as the authenticating user. Returns the blocked user in the requested format when successful. You can find out more about blocking in the Twitter Support Knowledge Base. | http://twitter.com/blocks/create/id.format | xml, json | POST | id | |
| destroy | Un-blocks the user specified in the ID parameter as the authenticating user. Returns the un-blocked user in the requested format when successful. | http://twitter.com/blocks/destroy/id.format | xml, json | POST, DELETE | id |
Help Methods
| Type | Method | Description | URI | Formats | API Limit | Parameters |
|---|---|---|---|---|---|---|
| test | Returns the string "ok" in the requested format with a 200 OK HTTP status code. | http://twitter.com/help/test.format | xml, json | GET | ||
| downtime_schedule | Returns the same text displayed on http://twitter.com/home when a maintenance window is scheduled, in the requested format. | http://twitter.com/help/downtime_schedule.format | xml, json | GET |
