分享到 :

add_idol

1 接口说明

收听腾讯微博上的用户。

1.1 URL

OAuth2.0协议: https://graph.qq.com/relation/add_idol

1.2 格式

JSON,XML

1.3 HTTP请求方式

POST

1.4 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)通用参数

-OAuth2.0协议必须传入的通用参数,详见这里

(2)私有参数

参数名称 是否必须 类型 描述
format string 定义API返回的数据格式。
取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。 

注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。

name string 要收听的用户的账户名列表。多个账户名之间用“,”隔开,例如:abc,bcde,cde。最多30个。 

可选,name和fopenids至少选一个,若同时存在则以name值为主。

fopenids string 要收听的用户的openid列表。多个openid之间用“_”隔开,例如:B624064BA065E01CB73F835017FE96FA_B624064BA065E01CB73F835017FE96FB。最多30个。 

可选,name和fopenids至少选一个,若同时存在则以name值为主。

1.5 请求示例

以OAuth2.0协议为例,POST请求包示例:

POST /relation/add_idol HTTP/1.1

Host: graph.qq.com

Content-Type: application/x-www-form-urlencoded

Content-Length: 352

Connection: Keep-Alive

Cache-Control: no-cache

access_token=*************& oauth_consumer_key=123456& openid=****************&
format=xml& name=abc,bcde,cde& fopenids=B624064BA065E01CB73F835017FE96FA_B624064BA065E01CB73F835017FE96FB

1.6 返回参数说明

参数名称 描述
ret 返回码。 

-公共返回码说明详见:公共返回码说明

-微博OpenAPI私有返回码详见:微博私有返回码说明

errcode 二级错误码,详见:微博私有返回码说明
msg 如果ret不为0,会有相应的错误信息提示,返回数据全部用UTF-8编码。

 

1.7 正确返回示例

 

1.8 错误返回示例

 

 

返回顶部