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":"", //错误信息 }
其他
无