分享到 :

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>

 

返回顶部