API文档 V2/en

跳转到: 导航, 搜索
(Read API)
(撤销由Xuezheng讨论)所作出的修订8334)
 
(未显示1个用户的77个中间版本)
第1行: 第1行:
== Status API ==
+
== Weibo API ==
 
=== Read API ===
 
=== Read API ===
 
*[[2/statuses/public_timeline/en|statuses/public_timeline]] Return the latest public weibos
 
*[[2/statuses/public_timeline/en|statuses/public_timeline]] Return the latest public weibos
 
*[[2/statuses/friends_timeline/en|statuses/friends_timeline]]  Return the authenticating user’s and his friends’ latest weibos
 
*[[2/statuses/friends_timeline/en|statuses/friends_timeline]]  Return the authenticating user’s and his friends’ latest weibos
 
*[[2/statuses/home_timeline/en|statuses/home_timeline]]  Return the authenticating user’s and his friends’ latest weibos
 
*[[2/statuses/home_timeline/en|statuses/home_timeline]]  Return the authenticating user’s and his friends’ latest weibos
*[[2/statuses/friends_timeline/ids/en|statuses/friends_timeline/ids]]  Return the authenticating user’s and his friends’ latest weibos'ID
+
*[[2/statuses/friends_timeline/ids/en|statuses/friends_timeline/ids]]  Return the authenticating user’s and his friends’ latest weibos ID
 
*[[2/statuses/user_timeline/en|statuses/user_timeline]] Return the latest weibos of one user
 
*[[2/statuses/user_timeline/en|statuses/user_timeline]] Return the latest weibos of one user
*[[2/statuses/user_timeline/ids/en|statuses/user_timeline/ids]] Return the latest weibos'ID of one user<span style="color:red;">New!</span>
+
*[[2/statuses/user_timeline/ids/en|statuses/user_timeline/ids]] Return the latest weibos ID of one user{{Icon_new2}}
 
*[[2/statuses/repost_timeline/en|statuses/repost_timeline]] Return the latest of repost weibos of a original weibo
 
*[[2/statuses/repost_timeline/en|statuses/repost_timeline]] Return the latest of repost weibos of a original weibo
*[[2/statuses/repost_timeline/ids/en|statuses/repost_timeline/ids]] Return the latest of repost weibos'ID of a original weibo<span style="color:red;">New!</span>
+
*[[2/statuses/repost_timeline/ids/en|statuses/repost_timeline/ids]] Return the latest of repost weibos ID of a original weibo{{Icon_new2}}
 
*[[2/statuses/repost_by_me/en|statuses/repost_by_me]] Return the latest of repost weibos of authenticating user  
 
*[[2/statuses/repost_by_me/en|statuses/repost_by_me]] Return the latest of repost weibos of authenticating user  
 
*[[2/statuses/mentions/en|statuses/mentions]] Return the latest weibos metioned the authenticating user
 
*[[2/statuses/mentions/en|statuses/mentions]] Return the latest weibos metioned the authenticating user
*[[2/statuses/mentions/ids/en|statuses/mentions/ids]] Return the latest weibos‘ID metioned the authenticating user<span style="color:red;">New!</span>
+
*[[2/statuses/mentions/ids/en|statuses/mentions/ids]] Return the latest weibos‘ID metioned the authenticating user{{Icon_new2}}
*[[2/statuses/bilateral_timeline/en|statuses/bilateral_timeline]] Return the user's latest weibos that followed the authenticating user and is followed by the authenticating user<span style="color:red;">New!</span>
+
*[[2/statuses/bilateral_timeline/en|statuses/bilateral_timeline]] Return the latest weibos of the users that are following the authenticating user and are being followed by the authenticating user{{Icon_new2}}
 
*[[2/statuses/show/en|statuses/show]] Return the single weibo’s content by its ID
 
*[[2/statuses/show/en|statuses/show]] Return the single weibo’s content by its ID
 
*[[2/statuses/querymid/en|statuses/querymid]] Return the mid by ID
 
*[[2/statuses/querymid/en|statuses/querymid]] Return the mid by ID
第27行: 第27行:
 
*[[2/statuses/update/en|statuses/update]] Post a weibo
 
*[[2/statuses/update/en|statuses/update]] Post a weibo
 
*[[2/statuses/upload/en|statuses/upload]] Upload a picture with a new weibo
 
*[[2/statuses/upload/en|statuses/upload]] Upload a picture with a new weibo
*[[2/statuses/upload_url_text/en|statuses/upload_url_text]] Upload a picture by a picture URL with a new weibo
+
*[[2/statuses/upload_url_text/en|statuses/upload_url_text]] Upload a picture by a picture URL with a new weibo {{Icon_adv}}
 
*[[2/emotions/en|emotions]]  Emotion interface, return the emotion list
 
*[[2/emotions/en|emotions]]  Emotion interface, return the emotion list
  
== Comment API ==
+
== Comments API ==
 
=== Read API ===
 
=== Read API ===
 
*[[2/comments/show/en|comments/show]] Return comments of one weibo
 
*[[2/comments/show/en|comments/show]] Return comments of one weibo
第45行: 第45行:
 
*[[2/comments/reply/en|comments/reply]] Reply a comment
 
*[[2/comments/reply/en|comments/reply]] Reply a comment
  
== User API ==
+
== Users API ==
 
=== Read API ===
 
=== Read API ===
*[[2/users/show/en|users/show]] Return user profile by user ID<span style="color:red;">New!</span>
+
*[[2/users/show/en|users/show]] Return user profile by user ID{{Icon_new2}}
 
*[[2/users/domain_show/en|users/domain_show]] Return user profile and the latest weibo by user’s personalized weibo url
 
*[[2/users/domain_show/en|users/domain_show]] Return user profile and the latest weibo by user’s personalized weibo url
 
*[[2/users/counts/en|users/counts]] Return the followers counts,friends counts, and weibo counts of a batch of users
 
*[[2/users/counts/en|users/counts]] Return the followers counts,friends counts, and weibo counts of a batch of users
  
== Friendship API ==
+
== Friendships API ==
 
=== Friend Read API ===
 
=== Friend Read API ===
*[[2/friendships/friends/en|friendships/friends]]
+
*[[2/friendships/friends/en|friendships/friends]] Return the friends list of a user
*[[2/friendships/friends/in_common/en|friendships/friends/in_common]]
+
*[[2/friendships/friends/in_common/en|friendships/friends/in_common]] Return the common friends list between two users
*[[2/friendships/friends/bilateral/en|friendships/friends/bilateral]]
+
*[[2/friendships/friends/bilateral/en|friendships/friends/bilateral]] Return list of users that are following the specified user and are being followed by the specified user
*[[2/friendships/friends/bilateral/ids/en|friendships/friends/bilateral/ids]]
+
*[[2/friendships/friends/bilateral/ids/en|friendships/friends/bilateral/ids]] Return ID of users that are following the specified user and are being followed by the specified user
*[[2/friendships/friends/ids/en|friendships/friends/ids]]
+
*[[2/friendships/friends/ids/en|friendships/friends/ids]] Return the friends ID list of a user
 +
 
 
=== Follower Read API ===
 
=== Follower Read API ===
*[[2/friendships/followers/en|friendships/followers]]
+
*[[2/friendships/followers/en|friendships/followers]] Return the followers list of a user
*[[2/friendships/followers/ids/en|friendships/followers/ids]]
+
*[[2/friendships/followers/ids/en|friendships/followers/ids]] Return the followers ID list of a user
*[[2/friendships/followers/active/en|friendships/followers/active]]
+
*[[2/friendships/followers/active/en|friendships/followers/active]] Return the high quality followers list of a user
 +
 
 
=== Friendship Chain Read API ===
 
=== Friendship Chain Read API ===
*[[2/friendships/friends_chain/followers/en|friendships/friends_chain/followers]]
+
*[[2/friendships/friends_chain/followers/en|friendships/friends_chain/followers]] Return users that are being followed by the authenticating user and are following the specified user
  
 
=== Friendship Read API ===
 
=== Friendship Read API ===
第69行: 第71行:
 
=== Write API ===
 
=== Write API ===
 
*[[2/friendships/create/en|friendships/create]] Follow a user
 
*[[2/friendships/create/en|friendships/create]] Follow a user
*[[2/friendships/destroy/en|friendships/destroy]]  Unfollow a user
+
*[[2/friendships/destroy/en|friendships/destroy]]  Cancel following a user
*[[2/friendships/remark/update/en|friendships/remark/update]]
+
*[[2/friendships/remark/update/en|friendships/remark/update]] Update remarks of the friends {{Icon_adv}}
  
 
+
== Accounts API ==
== Account API ==
+
 
=== Read API ===
 
=== Read API ===
*[[2/account/profile/basic/en|account/profile/basic]]
+
*[[2/account/get_privacy/en|account/get_privacy]] Return authenticating user’s privacy settings
*[[2/account/profile/education/en|account/profile/education]]
+
*[[2/account/profile/school_list/en|account/profile/school_list]] Return the school list
*[[2/account/profile/career/en|account/profile/career]]
+
*[[2/account/rate_limit_status/en|account/rate_limit_status]] Return the authenticating user’s API access rate limitation
*[[2/account/get_privacy/en|account/get_privacy]]
+
*[[2/account/get_uid/en|account/get_uid]] Return user ID after OAuth authorization (the same function as  [[account/verify_credentials]])
*[[2/account/profile/school_list/en|account/profile/school_list]]
+
 
*[[2/account/rate_limit_status/en|account/rate_limit_status]]
+
*[[2/account/get_uid/en|account/get_uid]]
+
 
=== Write API ===
 
=== Write API ===
 
*[[2/account/end_session/en|account/end_session]] End the session of authenticating user
 
*[[2/account/end_session/en|account/end_session]] End the session of authenticating user
*[[2/account/profile/basic_update/en|account/profile/basic_update]]
 
*[[2/account/profile/edu_update/en|account/profile/edu_update]]
 
*[[2/account/profile/edu_destroy/en|account/profile/edu_destroy]]
 
*[[2/account/profile/car_update/en|account/profile/car_update]]
 
*[[2/account/profile/car_destroy/en|account/profile/car_destroy]]
 
*[[2/account/avatar/upload/en|account/avatar/upload]]
 
*[[2/account/update_privacy/en|account/update_privacy]]
 
  
== Favorite API ==
+
== Favorites API ==
 
=== Read API ===
 
=== Read API ===
 
*[[2/favorites/en|favorites]] Return authenticating user’s favorites list
 
*[[2/favorites/en|favorites]] Return authenticating user’s favorites list
*[[2/favorites/ids/en|favorites/ids]]
+
*[[2/favorites/ids/en|favorites/ids]] Return authenticating user’s favorites ID list{{Icon_new2}}
*[[2/favorites/show/en|favorites/show]]
+
*[[2/favorites/show/en|favorites/show]] Return one of the user's favorites by ID
*[[2/favorites/by_tags/en|favorites/by_tags]]
+
*[[2/favorites/by_tags/en|favorites/by_tags]] Return authenticating user’s favorites list of one tag
*[[2/favorites/tags/en|favorites/tags]]
+
*[[2/favorites/tags/en|favorites/tags]] Return authenticating user’s favorites tag list
*[[2/favorites/by_tags/ids/en|favorites/by_tags/ids]]
+
*[[2/favorites/by_tags/ids/en|favorites/by_tags/ids]] Return authenticating user’s favorites ID list of one tag{{Icon_new2}}
 +
 
 
=== Write API ===
 
=== Write API ===
*[[2/favorites/create/en|favorites/create]] Add a weibo as favorite
+
*[[2/favorites/create/en|favorites/create]] Add a weibo to the favorite list
 
*[[2/favorites/destroy/en|favorites/destroy]] Delete a weibo from favorite list of the authenticating user
 
*[[2/favorites/destroy/en|favorites/destroy]] Delete a weibo from favorite list of the authenticating user
*[[2/favorites/destroy_batch/en|favorites/destroy_batch]] Delete a batch of weibos from favorite list
+
*[[2/favorites/destroy_batch/en|favorites/destroy_batch]] Delete a batch of favorites from favorite list
*[[2/favorites/tags/update/en|favorites/tags/update]]
+
*[[2/favorites/tags/update/en|favorites/tags/update]] Update the tag of a favorite
*[[2/favorites/tags/update_batch/en|favorites/tags/update_batch]]
+
*[[2/favorites/tags/update_batch/en|favorites/tags/update_batch]] Update a specified tag of authenticating user's all the favorites
*[[2/favorites/tags/destroy_batch/en|favorites/tags/destroy_batch]]
+
*[[2/favorites/tags/destroy_batch/en|favorites/tags/destroy_batch]] Delete a specified tag of authenticating user's all the favorites
  
== Trend API ==
+
== Topics API ==
 
=== Read API ===
 
=== Read API ===
*[[2/trends/en|trends]] Returns trends of a user
+
*[[2/trends/en|trends]] Return topics of a user
*[[2/trends/is_follow/en|trends/is_follow]]
+
*[[2/trends/is_follow/en|trends/is_follow]] Whether follow a topic or not
*[[2/trends/statuses/en|trends/statuses]] Returns the weibos belong to the trends
+
*[[2/trends/hourly/en|trends/hourly]] Return hot topics by hour
*[[2/trends/hourly/en|trends/hourly]] Hot trends by hour
+
*[[2/trends/daily/en|trends/daily]] Return hot topics by day
*[[2/trends/daily/en|trends/daily]] Return trends by date
+
*[[2/trends/weekly/en|trends/weekly]] Return hot topics by week
*[[2/trends/weekly/en|trends/weekly]] Return trends by week
+
 
 
=== Write API ===
 
=== Write API ===
*[[2/trends/follow/en|trends/follow]] Follow a trends
+
*[[2/trends/follow/en|trends/follow]] Follow a topic
*[[2/trends/destroy/en|trends/destroy]] Unfollow a trends
+
*[[2/trends/destroy/en|trends/destroy]] Cancel following a topic
  
== Tag API ==
+
== Tags API ==
 
=== Read API ===
 
=== Read API ===
*[[2/tags/en|tags]] Return the tag list by  user ID
+
*[[2/tags/en|tags]] Return the tags list by  user ID
*[[2/tags/tags_batch/en|tags/tags_batch]]
+
*[[2/tags/tags_batch/en|tags/tags_batch]] Return the tags list of a batch of users
*[[2/tags/suggestions/en|tags/suggestions]] Return the recommended tags for the current user
+
*[[2/tags/suggestions/en|tags/suggestions]] Return the recommended tags list for the authenticating user
 +
 
 
=== Write API ===
 
=== Write API ===
*[[2/tags/create/en|tags/create]] Create a tag for current user
+
*[[2/tags/create/en|tags/create]] Create tags for the authenticating user
 
*[[2/tags/destroy/en|tags/destroy]] Delete a tag
 
*[[2/tags/destroy/en|tags/destroy]] Delete a tag
 
*[[2/tags/destroy_batch/en|tags/destroy_batch]] Delete a batch of tags
 
*[[2/tags/destroy_batch/en|tags/destroy_batch]] Delete a batch of tags
第132行: 第126行:
 
== Register API ==
 
== Register API ==
 
=== Read API ===
 
=== Read API ===
*[[2/register/verify_nickname/en|register/verify_nickname]]
+
*[[2/register/verify_nickname/en|register/verify_nickname]] Whether a specified nickname is available
  
 
== Search API ==
 
== Search API ==
 
=== Suggestion Search API ===
 
=== Suggestion Search API ===
*[[2/search/suggestions/users/en|search/suggestions/users]]
+
*[[2/search/suggestions/users/en|search/suggestions/users]] Suggestions for searching users
*[[2/search/suggestions/statuses/en|search/suggestions/statuses]]
+
*[[2/search/suggestions/statuses/en|search/suggestions/statuses]] Suggestions for searching weibos
*[[2/search/suggestions/schools/en|search/suggestions/schools]]
+
*[[2/search/suggestions/schools/en|search/suggestions/schools]] Suggestions for searching schools
*[[2/search/suggestions/companies/en|search/suggestions/companies]]
+
*[[2/search/suggestions/companies/en|search/suggestions/companies]] Suggestions for searching companies
*[[2/search/suggestions/apps/en|search/suggestions/apps]]
+
*[[2/search/suggestions/apps/en|search/suggestions/apps]] Suggestions for searching applications
*[[2/search/suggestions/at_users/en|search/suggestions/at_users]]
+
*[[2/search/suggestions/at_users/en|search/suggestions/at_users]] Suggestions for '@username'
 +
 
 
=== Content Search API ===
 
=== Content Search API ===
*[[2/search/statuses/en|search/statuses]]
+
*[[2/search/statuses/en|search/statuses]] Search for weibos {{Icon_adv}}
 +
 
 
=== User Search API ===
 
=== User Search API ===
*[[2/search/users/en|search/users]]
+
*[[2/search/users/en|search/users]] Search for users {{Icon_adv}}
 
+
  
 
== Recommend API ==
 
== Recommend API ==
 
=== Read API ===
 
=== Read API ===
*[[2/suggestions/users/hot/en|suggestions/users/hot]]
+
*[[2/suggestions/users/hot/en|suggestions/users/hot]] Return system recommended users
*[[2/suggestions/users/may_interested/en|suggestions/users/may_interested]]
+
*[[2/suggestions/users/may_interested/en|suggestions/users/may_interested]] Return users the authenticating user may be interested in
*[[2/suggestions/users/by_status/en|suggestions/users/by_status]]
+
*[[2/suggestions/users/by_status/en|suggestions/users/by_status]] Return recommended users by the weibo content
*[[2/suggestions/statuses/hot/en|suggestions/statuses/hot]]
+
*[[2/suggestions/statuses/hot/en|suggestions/statuses/hot]] Return the selected weibos{{Icon_new2}}
*[[2/suggestions/statuses/reorder/en|suggestions/statuses/reorder]]
+
*[[2/suggestions/statuses/reorder/en|suggestions/statuses/reorder]] Return authenticating user's friends' weibos by the interest recommended order
*[[2/suggestions/statuses/reorder/ids/en|suggestions/statuses/reorder/ids]]
+
*[[2/suggestions/statuses/reorder/ids/en|suggestions/statuses/reorder/ids]] Return authenticating user's friends' weibos ID list by the interest recommended order
*[[2/suggestions/favorites/hot/en|suggestions/favorites/hot]]
+
*[[2/suggestions/favorites/hot/en|suggestions/favorites/hot]] Return the hot favorites
 +
 
 
=== Write API ===
 
=== Write API ===
*[[2/suggestions/users/not_interested/en|suggestions/users/not_interested]]
+
*[[2/suggestions/users/not_interested/en|suggestions/users/not_interested]] Mark somebody as the person the authenticating user is not interested in
  
 
== Remind API ==
 
== Remind API ==
 
=== Read API ===
 
=== Read API ===
*[[2/remind/unread_count/en|remind/unread_count]]
+
*[[2/remind/unread_count/en|remind/unread_count]] Return all kinds of unread count of a user{{Icon_new2}}
  
 
== Public Service API ==
 
== Public Service API ==
 
=== Read API ===
 
=== Read API ===
*[[2/common/code_to_location/en|common/code_to_location]]
+
*[[2/common/code_to_location/en|common/code_to_location]] Return address names by address codes{{Icon_new2}}
*[[2/common/get_city/en|common/get_city]]
+
*[[2/common/get_city/en|common/get_city]] Return cities list{{Icon_new2}}
*[[2/common/get_province/en|common/get_province]]
+
*[[2/common/get_province/en|common/get_province]] Return provinces list{{Icon_new2}}
*[[2/common/get_country/en|common/get_country]]
+
*[[2/common/get_country/en|common/get_country]] Return countries list{{Icon_new2}}
*[[2/common/get_timezone/en|common/get_timezone]]
+
*[[2/common/get_timezone/en|common/get_timezone]] Return timezone configurations list{{Icon_new2}}
  
 
== Geo  API ==
 
== Geo  API ==
 
=== Location Read API ===
 
=== Location Read API ===
*[[2/location/base/get_map_image/en|location/base/get_map_image]]
+
*[[2/location/base/get_map_image/en|location/base/get_map_image]] Generate a static map
 +
 
 
=== Coordinate API ===
 
=== Coordinate API ===
*[[2/location/geo/ip_to_geo/en|location/geo/ip_to_geo]]
+
*[[2/location/geo/ip_to_geo/en|location/geo/ip_to_geo]] Return geography information coordinate by IP
*[[2/location/geo/address_to_geo/en|location/geo/address_to_geo]]
+
*[[2/location/geo/address_to_geo/en|location/geo/address_to_geo]] Return geography information coordinate by practical address
*[[2/location/geo/geo_to_address/en|location/geo/geo_to_address]]
+
*[[2/location/geo/geo_to_address/en|location/geo/geo_to_address]] Return practical address by geography information coordinate
*[[2/location/geo/gps_to_offset/en|location/geo/gps_to_offset]]
+
*[[2/location/geo/gps_to_offset/en|location/geo/gps_to_offset]] Return deviated coordinate by GPS coordinate
*[[2/location/geo/is_domestic/en|location/geo/is_domestic]]
+
*[[2/location/geo/is_domestic/en|location/geo/is_domestic]] Whether geography information coordinates are domestic coordinates
 +
 
 
=== POI Data Read API ===
 
=== POI Data Read API ===
*[[2/location/pois/show_batch/en|location/pois/show_batch]]
+
*[[2/location/pois/show_batch/en|location/pois/show_batch]] Return a batch of POI informations
*[[2/location/pois/search/by_location/en|location/pois/search/by_location]]
+
*[[2/location/pois/search/by_location/en|location/pois/search/by_location]] Return POI informations according to location by keyword
*[[2/location/pois/search/by_geo/en|location/pois/search/by_geo]]
+
*[[2/location/pois/search/by_geo/en|location/pois/search/by_geo]] Return POI informations according to coordinate range by keyword
*[[2/location/pois/search/by_area/en|location/pois/search/by_area]]
+
*[[2/location/pois/search/by_area/en|location/pois/search/by_area]] Return POI informations according to rectangular area by keyword
 +
 
 
=== POI Data Write API ===
 
=== POI Data Write API ===
*[[2/location/pois/add/en|location/pois/add]]
+
*[[2/location/pois/add/en|location/pois/add]] Create a new POI information
 +
 
 
=== Mobile Service Read API ===
 
=== Mobile Service Read API ===
*[[2/location/mobile/get_location/en|location/mobile/get_location]]
+
*[[2/location/mobile/get_location/en|location/mobile/get_location]] Return current location information by mobile base station WIFI
 +
 
 
=== Traffic Route Read API ===
 
=== Traffic Route Read API ===
*[[2/location/line/drive_route/en|location/line/drive_route]]
+
*[[2/location/line/drive_route/en|location/line/drive_route]] Return self driving route information by starting point and terminal point
*[[2/location/line/bus_route/en|location/line/bus_route]]
+
*[[2/location/line/bus_route/en|location/line/bus_route]] Return bus route information by starting point and terminal point
*[[2/location/line/bus_line/en|location/line/bus_line]]
+
*[[2/location/line/bus_line/en|location/line/bus_line]] Return bus route information by keyword
*[[2/location/line/bus_station/en|location/line/bus_station]]
+
*[[2/location/line/bus_station/en|location/line/bus_station]] Return bus station information by keyword
  
== OAuth 2.0 API ==
+
== OAuth 2.0 API (Version 2 APIs only support OAuth 2.0 authorization)==
*[[2/oauth2/access_token/en|oauth2/access_token]]
+
*[[2/oauth2/access_token/en|oauth2/access_token]] Return authorized Access Token
*[[2/oauth2/authorize/en|oauth2/authorize]]  
+
*[[2/oauth2/authorize/en|oauth2/authorize]] Request user authorization
  
  

2012年4月17日 (二) 16:20的最后版本

目录

Weibo API

Read API

Write API

Comments API

Read API

Write API

Users API

Read API

  • users/show Return user profile by user ID
  • users/domain_show Return user profile and the latest weibo by user’s personalized weibo url
  • users/counts Return the followers counts,friends counts, and weibo counts of a batch of users

Friendships API

Friend Read API

Follower Read API

Friendship Chain Read API

Friendship Read API

Write API

Accounts API

Read API

Write API

Favorites API

Read API

Write API

Topics API

Read API

Write API

Tags API

Read API

Write API

Register API

Read API

Search API

Suggestion Search API

Content Search API

User Search API

Recommend API

Read API

Write API

Remind API

Read API

Public Service API

Read API

Geo API

Location Read API

Coordinate API

POI Data Read API

POI Data Write API

Mobile Service Read API

Traffic Route Read API

OAuth 2.0 API (Version 2 APIs only support OAuth 2.0 authorization)




Language: 中文  | English
文档更新时间: 2012-04-17