分享到 :

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 正确返回示例

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <ret>0</ret>
  <errcode>0</errcode>
  <msg>ok</msg>
</data>

 

1.8 错误返回示例

 

<?xml version="1.0" encoding="UTF-8" ?>
<root>
   <data>
       <ret>1002</ret>
       <msg><![CDATA[请先登录]]></msg>
   </data>
</root>

 

返回顶部