Search/suggestions/at users
目录 |
search/suggestions/at_users
在@某人时，实时获取用户名建议。也可作关注人、粉丝搜索。
URL
http://api.t.sina.com.cn/search/suggestions/at_users.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
关于授权机制，参见授权机制声明
请求数限制
true
关于请求数限制，参见接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| source | true | string | 申请应用时分配的AppKey，调用接口时候代表应用的唯一身份。（采用OAuth授权方式不需要此参数） |
| q | true | string | 搜索的关键字。必须进行URL_encoding。UTF-8编码 |
| count | false | int | 每页返回结果数。默认10 |
| type | true | int | 1代表粉丝，0代表关注人。另外， 粉丝最多返回1000个，关注人最多2000个 |
| range | false | int | 0代表只查关注人，1代表只搜索当前用户对关注人的备注，2表示都查. 默认为2. |
注意事项
无
返回结果
XML示例
<suggestions> <suggestion> <uid>2436652</uid> <nickname>啊啊</nickname> <remark>企</remark> </suggestion> <suggestion> <uid>243652</uid> <nickname>啊啊啊</nickname> <remark>企鹅</remark> </suggestion> </suggestions>
JSON示例
//成功返回
[
{
"uid" : //粉丝或关注人ID
"nickname" : //粉丝或关注人昵称
"remark" : //关注人的备注（如果是关注人的话，否则为空符号串
},
{
"uid" : //粉丝或关注人ID
"nickname" : //粉丝或关注人昵称
"remark" : //关注人的备注（如果是关注人的话，否则为空符号串
},
]
//失败返回：
JSON：（失败）
{
"request":"" //调用地址
"error_code":"400", //错误代码
"error":"", //错误信息
}
其他
无
文档更新时间: 2011-05-06
