API文档/en
(创建新页面为 '== REST API == ===Timeline API === *statuses/public_timeline Return the latest public weibos. *statuses/friends_timeline Return the authenticating user’s and his frie…') |
|||
| （未显示1个用户的7个中间版本） | |||
| 第1行： | 第1行： | ||
== REST API == | == REST API == | ||
===Timeline API === | ===Timeline API === | ||
| − | *[[statuses/public_timeline]] Return the latest public weibos. | + | *[[statuses/public_timeline/en|statuses/public_timeline]] Return the latest public weibos. |
| − | *[[statuses/friends_timeline]] Return the authenticating user’s and his friends’ latest weibos ( Alias: statues/home_timeline) | + | *[[statuses/friends_timeline/en|statuses/friends_timeline]] Return the authenticating user’s and his friends’ latest weibos ( Alias: statues/home_timeline) |
| − | *[[statuses/user_timeline]] Return the authenticating user’s latest weibos. | + | *[[statuses/user_timeline/en|statuses/user_timeline]] Return the authenticating user’s latest weibos. |
| − | *[[statuses/mentions]] Return the authenticating user’s mentions | + | *[[statuses/mentions/en|statuses/mentions]] Return the authenticating user’s mentions |
| − | *[[statuses/comments_timeline]] Return comments of the authenticating user made and received | + | *[[statuses/comments_timeline/en|statuses/comments_timeline]] Return comments of the authenticating user made and received |
| − | *[[statuses/comments_by_me]] Return comments made by the authenticating user | + | *[[statuses/comments_by_me/en|statuses/comments_by_me]] Return comments made by the authenticating user |
| − | *[[statuses/comments_to_me]] Return comments the authenticating user received | + | *[[statuses/comments_to_me/en|statuses/comments_to_me]] Return comments the authenticating user received |
| − | *[[statuses/comments]] Return the weibo’s comment list by the weibo ID | + | *[[statuses/comments/en|statuses/comments]] Return the weibo’s comment list by the weibo ID |
| − | *[[statuses/counts]] Return the comment counts and repost counts of a list of weibos | + | *[[statuses/counts/en|statuses/counts]] Return the comment counts and repost counts of a list of weibos |
| − | *[[statuses/repost_timeline]] Return the latest of repost weibos of a original weibo. <span style="color:red;">New!</span> | + | *[[statuses/repost_timeline/en|statuses/repost_timeline]] Return the latest of repost weibos of a original weibo. <span style="color:red;">New!</span> |
| − | *[[statuses/repost_by_me]] Return the latest repost weibos of authenticating user <span style="color:red;">New!</span> | + | *[[statuses/repost_by_me/en|statuses/repost_by_me]] Return the latest repost weibos of authenticating user <span style="color:red;">New!</span> |
| − | *[[statuses/unread]] | + | *[[statuses/unread/en|statuses/unread]] Return the authenticating user’s unread weibo count |
| − | *[[statuses/reset_count]] Reset unread weibo count | + | *[[statuses/reset_count/en|statuses/reset_count]] Reset unread weibo count |
| − | *[[emotions]] Emotion Iinterface, return the emotion list | + | *[[emotions/en|emotions]] Emotion Iinterface, return the emotion list |
| − | === Weibo | + | === Weibo Access API === |
| − | *[[statuses/show]] Return the single weibo’s content by its ID | + | *[[statuses/show/en|statuses/show]] Return the single weibo’s content by its ID |
| − | *[[user/statuses/id]] Jump to the content page of weibo by its ID and user ID. | + | *[[user/statuses/id/en|user/statuses/id]] Jump to the content page of weibo by its ID and user ID. |
| − | *[[statuses/update]] Post a weibo <span style="color:red">Updated!</span> | + | *[[statuses/update/en|statuses/update]] Post a weibo <span style="color:red">Updated!</span> |
| − | *[[statuses/upload]] Post a weibo with | + | *[[statuses/upload/en|statuses/upload]] Post a weibo with picture. |
| − | *[[statuses/destroy]] Delete a weibo | + | *[[statuses/destroy/en|statuses/destroy]] Delete a weibo |
| − | *[[statuses/repost]] Repost a weibo <span style="color:red">Updated!</span> | + | *[[statuses/repost/en|statuses/repost]] Repost a weibo <span style="color:red">Updated!</span> |
| − | *[[statuses/comment]] Post a comment to a weibo | + | *[[statuses/comment/en|statuses/comment]] Post a comment to a weibo |
| − | *[[statuses/comment_destroy|statuses/comment_destroy/:id]] Delete the authenticating user’s weibo | + | *[[statuses/comment_destroy/en|statuses/comment_destroy/:id]] Delete the authenticating user’s weibo |
| − | *[[statuses/comment/destroy_batch]] Delete a batch of comments of authenticating | + | *[[statuses/comment/destroy_batch/en|statuses/comment/destroy_batch]] Delete a batch of comments of authenticating user's weibo |
| − | *[[statuses/reply]] | + | *[[statuses/reply/en|statuses/reply]] Replay a weibo comment |
=== User API === | === User API === | ||
| − | *[[users/show]] Return user profile by user ID ( autheriszed user) | + | *[[users/show/en|users/show]] Return user profile by user ID (autheriszed user) |
| − | <div style="display:none;">*[[user/friends/update_define]] | + | <div style="display:none;">*[[user/friends/update_define/en|user/friends/update_define]] Update the following's remark</div> |
| − | *[[statuses/friends]] Return the user’s following list and the latest weibo of each following user | + | *[[statuses/friends/en|statuses/friends]] Return the user’s following list and the latest weibo of each following user |
| − | *[[statuses/followers]] Return the user’s follower list and the latest weibo of each follower | + | *[[statuses/followers/en|statuses/followers]] Return the user’s follower list and the latest weibo of each follower |
| − | *[[users/hot]] Return system recommended users | + | *[[users/hot/en|users/hot]] Return system recommended users |
| − | *[[user/friends/update_remark]] | + | *[[user/friends/update_remark/en|user/friends/update_remark]] Update remarks of authenticating user's following<span style="color:red">New!</span> |
| − | *[[ | + | *[[users/suggestions/en|users/suggestions]] Return the user that authenticating user may be interesting in<span style="color:red">Beta!</span> |
=== Direct message API === | === Direct message API === | ||
| − | *[[direct_messages]] Return the authenticating user’s latest direct message list | + | *[[direct_messages/en|direct_messages]] Return the authenticating user’s latest direct message list |
| − | *[[direct_messages/sent]] Return latest direct message list sent by the authenticating user | + | *[[direct_messages/sent/en|direct_messages/sent]] Return latest direct message list sent by the authenticating user |
| − | *[[direct_messages/new]] Send a direct message | + | *[[direct_messages/new/en|direct_messages/new]] Send a direct message |
| − | *[[direct_messages/destroy|direct_messages/destroy/:id]] Delete a specific direct message | + | *[[direct_messages/destroy/en|direct_messages/destroy/:id]] Delete a specific direct message |
| − | *[[direct_messages/destroy_batch]] Delete a batch of direct messages | + | *[[direct_messages/destroy_batch/en|direct_messages/destroy_batch]] Delete a batch of direct messages |
=== Friendships API=== | === Friendships API=== | ||
| − | *[[friendships/create]] Follow a user | + | *[[friendships/create/en|friendships/create]] Follow a user |
| − | *[[friendships/destroy]] Unfollow a user | + | *[[friendships/destroy/en|friendships/destroy]] Unfollow a user |
| − | *[[friendships/exists]] Check if already follow a user (Recommend to use friendships/show instead) | + | *[[friendships/exists/en|friendships/exists]] Check if already follow a user (Recommend to use friendships/show instead) |
| − | *[[friendships/show]] Return relationship of two users. | + | *[[friendships/show/en|friendships/show]] Return relationship of two users. |
| − | === | + | ===Trends API <span style="color:red">Beta!</span>=== |
| − | *[[trends]] | + | *[[trends/en|trends]] Returns trends of a user. |
| − | *[[trends/statuses]] | + | *[[trends/statuses/en|trends/statuses]] Returns the weibos belong to the trends |
| − | *[[trends/follow]] | + | *[[trends/follow/en|trends/follow]] Follow a trends |
| − | *[[trends/destroy]] | + | *[[trends/destroy/en|trends/destroy]] Unfollow a trends |
| − | *[[trends/hourly]] | + | *[[trends/hourly/en|trends/hourly]] Hot trends by hour |
| − | *[[trends/daily]] | + | *[[trends/daily/en|trends/daily]] Return trends by date. |
| − | *[[trends/weekly]] | + | *[[trends/weekly/en|trends/weekly]] Return trends by week. |
| − | === Social | + | === Social Graph API=== |
| − | *[[friends/ids ]] Return user’s following list | + | *[[friends/ids/en|friends/ids]] Return user’s following list |
| − | *[[followers/ids ]] Return user’s follower list | + | *[[followers/ids/en|followers/ids]] Return user’s follower list |
| − | ===Privacy API<span style="color:red; font-size:12px;">[NEW]</span>=== | + | ===Privacy API <span style="color:red; font-size:12px;">[NEW]</span>=== |
| − | *[[account/update_privacy]] Set privacy parameters | + | *[[account/update_privacy/en|account/update_privacy]] Set privacy parameters |
| − | *[[account/get_privacy]] Return current user’s privacy settings | + | *[[account/get_privacy/en|account/get_privacy]] Return current user’s privacy settings |
===Block API <span style="color:red; font-size:12px;">[NEW]</span>=== | ===Block API <span style="color:red; font-size:12px;">[NEW]</span>=== | ||
| − | *[[blocks/create]] Block a user | + | *[[blocks/create/en|blocks/create]] Block a user |
| − | *[[blocks/destroy]] Unblock a user | + | *[[blocks/destroy/en|blocks/destroy]] Unblock a user |
| − | *[[blocks/exists]] Check whether a user is in blocked | + | *[[blocks/exists/en|blocks/exists]] Check whether a user is in blocked |
| − | *[[blocks/blocking]] Return the blocked users list with detail | + | *[[blocks/blocking/en|blocks/blocking]] Return the blocked users list with detail |
| − | *[[blocks/blocking/ids]] Return the user IDs of blocking list in pages | + | *[[blocks/blocking/ids/en|blocks/blocking/ids]] Return the user IDs of blocking list in pages |
| − | ===Tags API<span style="color:red; font-size:12px;">[NEW]</span>=== | + | ===Tags API <span style="color:red; font-size:12px;">[NEW]</span>=== |
| − | *[[tags]] Return the tag list by user ID | + | *[[tags/en|tags]] Return the tag list by user ID |
| − | *[[tags/create]] Create a tag for current user | + | *[[tags/create/en|tags/create]] Create a tag for current user |
| − | *[[tags/suggestions]] Return the recommended tags for the current user | + | *[[tags/suggestions/en|tags/suggestions]] Return the recommended tags for the current user |
| − | *[[tags/destroy]] Delete a tag | + | *[[tags/destroy/en|tags/destroy]] Delete a tag |
| − | *[[tags/destroy_batch]] Delete a batch of tags | + | *[[tags/destroy_batch/en|tags/destroy_batch]] Delete a batch of tags |
===Account API === | ===Account API === | ||
| − | *[[account/verify_credentials]] Check if the user is authenticated | + | *[[account/verify_credentials/en|account/verify_credentials]] Check if the user is authenticated |
| − | *[[account/rate_limit_status]] Return the authenticating user’s API access rate limitation | + | *[[account/rate_limit_status/en|account/rate_limit_status]] Return the authenticating user’s API access rate limitation |
| − | *[[account/end_session]] End the session of authenticating user | + | *[[account/end_session/en|account/end_session]] End the session of authenticating user |
| − | *[[account/update_profile_image]] Update profile image | + | *[[account/update_profile_image/en|account/update_profile_image]] Update profile image |
| − | *[[account/update_profile]] Update profile | + | *[[account/update_profile/en|account/update_profile]] Update profile |
| − | *[[account/register]] Register a Sina Weibo account | + | *[[account/register/en|account/register]] Register a Sina Weibo account |
| − | *[[account/activate]] Activate a weibo account | + | *[[account/activate/en|account/activate]] Activate a weibo account |
=== Favorites API === | === Favorites API === | ||
| − | *[[favorites]] Return authenticating user’s favorites list | + | *[[favorites/en|favorites]] Return authenticating user’s favorites list |
| − | *[[favorites/create]] Add a weibo as favorite | + | *[[favorites/create/en|favorites/create]] Add a weibo as favorite |
| − | *[[favorites/destroy]] Delete a weibo from favorite list of the authenticating user | + | *[[favorites/destroy/en|favorites/destroy]] Delete a weibo from favorite list of the authenticating user |
| − | *[[favorites/destroy_batch]] Delete a batch of weibos from favorite list | + | *[[favorites/destroy_batch/en|favorites/destroy_batch]] Delete a batch of weibos from favorite list |
=== OAuth API === | === OAuth API === | ||
| − | *[[oauth]] about OAuth | + | *[[oauth/en|oauth]] about OAuth |
| − | *[[oauth/request_token]] Return unauthorized Request Token | + | *[[oauth/request_token/en|oauth/request_token]] Return unauthorized Request Token |
| − | *[[oauth/authorize]] Request Authorization Token.n | + | *[[oauth/authorize/en|oauth/authorize]] Request Authorization Token.n |
| − | *[[oauth/access_token]] Get the Access Token by Request Token | + | *[[oauth/access_token/en|oauth/access_token]] Get the Access Token by Request Token |
| − | <span style="display:none"> *[[xAuth]] about xAuth </span> | + | <span style="display:none"> *[[xAuth/en|xAuth]] about xAuth </span> |
== Search API== | == Search API== | ||
Note: The Search API currently is not available for all the developers. please contact @微博开放平台 or email us at weibo_app@vip.sina.com for more info. | Note: The Search API currently is not available for all the developers. please contact @微博开放平台 or email us at weibo_app@vip.sina.com for more info. | ||
===User search=== | ===User search=== | ||
| − | *[[users/search]] Search for weibo users <span style="color:red"> Updated!</span> | + | *[[users/search/en|users/search]] Search for weibo users <span style="color:red"> Updated!</span> |
| − | === Weibo | + | === Weibo Search API === |
| − | *[[search]] Search for weibo content | + | *[[search/en|search]] Search for weibo content |
| − | *[[statuses/search]] Search for weibo contents by | + | *[[statuses/search/en|statuses/search]] Search for weibo contents by multi-conditions |
== Geo API== | == Geo API== | ||
| − | Geo API is not available for all developers. Any questions, please contact @地理信息开放平台, or email us at | + | Geo API is not available for all developers. Any questions, please contact @地理信息开放平台, or email us at weibo_app@vip.sina.com for more info. |
=== Geo search API === | === Geo search API === | ||
| − | *[[location/route]] Search for car driving route | + | *[[location/route/en|location/route]] Search for car driving route |
| − | *[[location/bus]] Search for bus interchange info | + | *[[location/bus/en|location/bus]] Search for bus interchange info |
=== Geo transformation API === | === Geo transformation API === | ||
| − | *[[location/ip2xy]] Return the coordinated longitude and langtitude by IP address | + | *[[location/ip2xy/en|location/ip2xy]] Return the coordinated longitude and langtitude by IP address |
| − | *[[location/addr2xy]] Return the coordinated longitude and langtitude by the street address | + | *[[location/addr2xy/en|location/addr2xy]] Return the coordinated longitude and langtitude by the street address |
| − | *[[location/get_addr]] Return the street address of the specific longitude and langtitude | + | *[[location/get_addr/en|location/get_addr]] Return the street address of the specific longitude and langtitude |
== Test API == | == Test API == | ||
| − | *[[help/test]] Test API | + | *[[help/test/en|help/test]] Test API |
== Appendix == | == Appendix == | ||
=== Rest API Field Description === | === Rest API Field Description === | ||
| − | *[[status]] weibo content area | + | *[[status/en|status]] weibo content area |
| − | *[[user]] user profile area | + | *[[user/en|user]] user profile area |
| − | *[[comment]] comment of a weibo | + | *[[comment/en|comment]] comment of a weibo |
| − | *[[direct_message]] direct message | + | *[[direct_message/en|direct_message]] direct message |
| − | *[[ | + | *[[Province and city code table/en|Province and city code table]] |
| − | *[[Metadata]] metadata <span style="color:red;"> New!</span> | + | *[[Metadata/en|Metadata]] metadata <span style="color:red;"> New!</span> |
=== Geo field description === | === Geo field description === | ||
| − | *[[location/citycode]] City code table | + | *[[location/citycode/en|location/citycode]] City code table |
| − | *[[location/citycode_bus]] City code table that has bus information | + | *[[location/citycode_bus/en|location/citycode_bus]] City code table that has bus information |
| − | *[[location/category]] Category table | + | *[[location/category/en|location/category]] Category table |
2012年3月30日 (五) 15:47的最后版本
目录 |
REST API
Timeline API
- statuses/public_timeline Return the latest public weibos.
- statuses/friends_timeline Return the authenticating user’s and his friends’ latest weibos ( Alias: statues/home_timeline)
- statuses/user_timeline Return the authenticating user’s latest weibos.
- statuses/mentions Return the authenticating user’s mentions
- statuses/comments_timeline Return comments of the authenticating user made and received
- statuses/comments_by_me Return comments made by the authenticating user
- statuses/comments_to_me Return comments the authenticating user received
- statuses/comments Return the weibo’s comment list by the weibo ID
- statuses/counts Return the comment counts and repost counts of a list of weibos
- statuses/repost_timeline Return the latest of repost weibos of a original weibo. New!
- statuses/repost_by_me Return the latest repost weibos of authenticating user New!
- statuses/unread Return the authenticating user’s unread weibo count
- statuses/reset_count Reset unread weibo count
- emotions Emotion Iinterface, return the emotion list
Weibo Access API
- statuses/show Return the single weibo’s content by its ID
- user/statuses/id Jump to the content page of weibo by its ID and user ID.
- statuses/update Post a weibo Updated!
- statuses/upload Post a weibo with picture.
- statuses/destroy Delete a weibo
- statuses/repost Repost a weibo Updated!
- statuses/comment Post a comment to a weibo
- statuses/comment_destroy/:id Delete the authenticating user’s weibo
- statuses/comment/destroy_batch Delete a batch of comments of authenticating user's weibo
- statuses/reply Replay a weibo comment
User API
- users/show Return user profile by user ID (autheriszed user)
- statuses/friends Return the user’s following list and the latest weibo of each following user
- statuses/followers Return the user’s follower list and the latest weibo of each follower
- users/hot Return system recommended users
- user/friends/update_remark Update remarks of authenticating user's followingNew!
- users/suggestions Return the user that authenticating user may be interesting inBeta!
Direct message API
- direct_messages Return the authenticating user’s latest direct message list
- direct_messages/sent Return latest direct message list sent by the authenticating user
- direct_messages/new Send a direct message
- direct_messages/destroy/:id Delete a specific direct message
- direct_messages/destroy_batch Delete a batch of direct messages
Friendships API
- friendships/create Follow a user
- friendships/destroy Unfollow a user
- friendships/exists Check if already follow a user (Recommend to use friendships/show instead)
- friendships/show Return relationship of two users.
Trends API Beta!
- trends Returns trends of a user.
- trends/statuses Returns the weibos belong to the trends
- trends/follow Follow a trends
- trends/destroy Unfollow a trends
- trends/hourly Hot trends by hour
- trends/daily Return trends by date.
- trends/weekly Return trends by week.
Social Graph API
- friends/ids Return user’s following list
- followers/ids Return user’s follower list
Privacy API [NEW]
- account/update_privacy Set privacy parameters
- account/get_privacy Return current user’s privacy settings
Block API [NEW]
- blocks/create Block a user
- blocks/destroy Unblock a user
- blocks/exists Check whether a user is in blocked
- blocks/blocking Return the blocked users list with detail
- blocks/blocking/ids Return the user IDs of blocking list in pages
Tags API [NEW]
- tags Return the tag list by user ID
- tags/create Create a tag for current user
- tags/suggestions Return the recommended tags for the current user
- tags/destroy Delete a tag
- tags/destroy_batch Delete a batch of tags
Account API
- account/verify_credentials Check if the user is authenticated
- account/rate_limit_status Return the authenticating user’s API access rate limitation
- account/end_session End the session of authenticating user
- account/update_profile_image Update profile image
- account/update_profile Update profile
- account/register Register a Sina Weibo account
- account/activate Activate a weibo account
Favorites API
- favorites Return authenticating user’s favorites list
- favorites/create Add a weibo as favorite
- favorites/destroy Delete a weibo from favorite list of the authenticating user
- favorites/destroy_batch Delete a batch of weibos from favorite list
OAuth API
- oauth about OAuth
- oauth/request_token Return unauthorized Request Token
- oauth/authorize Request Authorization Token.n
- oauth/access_token Get the Access Token by Request Token
Search API
Note: The Search API currently is not available for all the developers. please contact @微博开放平台 or email us at weibo_app@vip.sina.com for more info.
User search
- users/search Search for weibo users Updated!
Weibo Search API
- search Search for weibo content
- statuses/search Search for weibo contents by multi-conditions
Geo API
Geo API is not available for all developers. Any questions, please contact @地理信息开放平台, or email us at weibo_app@vip.sina.com for more info.
Geo search API
- location/route Search for car driving route
- location/bus Search for bus interchange info
Geo transformation API
- location/ip2xy Return the coordinated longitude and langtitude by IP address
- location/addr2xy Return the coordinated longitude and langtitude by the street address
- location/get_addr Return the street address of the specific longitude and langtitude
Test API
- help/test Test API
Appendix
Rest API Field Description
- status weibo content area
- user user profile area
- comment comment of a weibo
- direct_message direct message
- Province and city code table
- Metadata metadata New!
Geo field description
- location/citycode City code table
- location/citycode_bus City code table that has bus information
- location/category Category table
文档更新时间: 2012-03-30
