2/friendships/friends/bilateral/en
(Created page with '{{api_desc_v2_en| uri=friendships/friends/bilateral| desc=获取用户的双向关注列表,即互粉列表| httpMethod=GET| needAuth=是| level={{Api_L1}}| rateLimit=是| para…') |
|||
第1行: | 第1行: | ||
{{api_desc_v2_en| | {{api_desc_v2_en| | ||
uri=friendships/friends/bilateral| | uri=friendships/friends/bilateral| | ||
− | desc= | + | desc=Return the list of the users that are following the specified user and are being followed by the specified user.| |
httpMethod=GET| | httpMethod=GET| | ||
− | needAuth= | + | needAuth=true| |
− | level={{ | + | level={{Api_L1_en}}| |
− | rateLimit= | + | rateLimit=true| |
− | params={{api_args|uid|true|int64| | + | params={{api_args|uid|true|int64|User ID to be specified.}} |
− | {{api_args|count|false|int| | + | {{api_args|count|false|int|The returned count for every page.The default value is 50. }} |
− | {{api_args|page|false|int| | + | {{api_args|page|false|int|The returned page.Default is 1. }} |
− | {{api_args|sort|false|int| | + | {{api_args|sort|false|int|Return the list by the sort type. 0: time sequence for following; Default is 0.}}| |
result= | result= | ||
<pre> | <pre> | ||
第64行: | 第64行: | ||
} | } | ||
</pre>| | </pre>| | ||
− | resultDes={{ | + | resultDes={{Rdes_user_en}}| |
− | useAge= | + | useAge=Currently only supports one kind of sort type.| |
− | otherInfo= | + | otherInfo=None |
}} | }} |
2012年1月10日 (二) 11:08的最后版本
friendships/friends/bilateral
Return the list of the users that are following the specified user and are being followed by the specified user.
URL
https://api.weibo.com/2/friendships/friends/bilateral.json
Supported Formats
JSON
HTTP Request Method
GET
Requires Login
true
See the Login and Authorization Mechanism Statement for login and authorization details.
Requests Count Limitation
Level:Normal
Count Limitation:true
See the Interface Access Rights Statement for the request count limitation details.
Request Parameters
Requires | Type and Range | Description | |
---|---|---|---|
source | false | string | This parameter is not needed when using OAuth.The value of this parameter is the AppKey. |
access_token | false | string | This parameter is required when using OAuth.You will get the access_token after oauth authorization. |
uid | true | int64 | User ID to be specified. |
count | false | int | The returned count for every page.The default value is 50. |
page | false | int | The returned page.Default is 1. |
sort | false | int | Return the list by the sort type. 0: time sequence for following; Default is 0. |
Notes
Currently only supports one kind of sort type.
Response
JSON Example
{ "users": [ { "id": 1404376560, "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", "domain": "zaku", "gender": "m", "followers_count": 1204, "friends_count": 447, "statuses_count": 2908, "favourites_count": 0, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "remark": "", "geo_enabled": true, "verified": false, "status": { "created_at": "Tue May 24 18:04:53 +0800 2011", "id": 11142488790, "text": "我的相机到了。", "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "mid": "5610221544300749636", "annotations": [], "reposts_count": 5, "comments_count": 8 }, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 215 }, ... ], "total_number": 668 }
See the Error Code Description for the error information details.
Field Description
Returned Field | Field Type | Field Description |
---|---|---|
id | int64 | User ID |
screen_name | string | User nickname |
name | string | Friendly displayed name |
province | int | Province ID user located |
city | int | City ID user located |
location | string | Address user located |
description | string | User description |
url | string | Url of the user’s blog |
profile_image_url | string | Profile image |
domain | string | The user’s personalized weibo url |
gender | string | Gender, m--male, f-- female, n-- unknown |
followers_count | int | Followers count |
friends_count | int | Friends count |
statuses_count | int | Weibo count |
favourites_count | int | Favorites count |
created_at | string | Created time |
following | boolean | Whether the current user is following the user |
allow_all_act_msg | boolean | Whether all the people can send direct message to the user |
geo_enabled | boolean | Whether can have the geography information |
verified | boolean | Whether the user is verified by his real identity, marked with “V” |
allow_all_comment | boolean | Whether all the people can comment the user's weibo |
avatar_large | string | Profile large image |
verified_reason | string | verification reason |
follow_me | boolean | Whether the user is following the current user |
online_status | int | Whether the user is online,0:offline、1:online |
bi_followers_count | int | The count of the users that are following the user and are being followed by the user |
status | object | The latest weibo of the user |
Others
None
文档更新时间: 2012-01-10