Socialgraph/getfans

出自天涯开放平台资源

跳转到: 导航, 搜索

目录

Socialgraph/getfans

获取当前用户粉丝列表

URL

http://open.tianya.cn/api/socialgraph/getfans.php

支持格式

XML/JSON

HTTP请求方式

POST

是否需要登录

true,关于授权机制,参见OAuth相关说明

请求参数

  必选 类型及范围 说明
appkey true string 申请应用时分配的appkey,调用接口时候代表应用的唯一身份
oauth_token true string 授权成功后所获得的 oauth_token
oauth_token_secret true string 授权成功后所获得的oauth_token_secret
timestamp true string 请求时候产生的时间戳time()
tempkey true string strtoupper(md5($timestamp.$appkey.$oauth_token.$oauth_token_secret.$appsecret))
page true int 当前页数
pagesize true int 每页的粉丝个数
outformat false string 可选,返回数据格式,默认为json

注意事项

若取当前用信息错误,则返回400错误,提示:"error_code"=>"40002", "error_msg"=>"request data error若取当前用信息错误,则返回400错误,提示: "error_code"=>"40002", "error_msg"=>"request data error"

返回结果

XML示例

<?xml version="1.0" encoding="utf8"?><data><total>10</total><user><item id="0"><group></group><bTwo>0</bTwo><fansCount>10</fansCount><bSpecial>0</bSpecial><province>北京</province><followCount>9</followCount><remark></remark><stardesc></stardesc><id>3438157</id><starurl></starurl><aboutMe></aboutMe><bFriend>1</bFriend><name>leonix_liu</name><city>宣武区</city><startype>0</startype><headimg>http://tx.tianyaui.com/logo/man/3438157</headimg></item></user></data><result>1</result><error></error>

JSON示例

{"data":{"total":10,"user":[{"group":"","bTwo":0,"fansCount":10,"bSpecial":0,"province":"\u5317\u4eac","followCount":9,"remark":"","stardesc":"","id":3438157,"starurl":"","aboutMe":"","bFriend":1,"name":"leonix_liu","city":"\u5ba3\u6b66\u533a","startype":0,"headimg":"http:\/\/tx.tianyaui.com\/logo\/man\/3438157"}]},"result":1,"error":""}

字段说明

  {   
 "result":"1",   
 "error":"",   
   "data":{   
      "total" : 213//总数   
     "user" : [   
         {      
             "id" : 1,   
          "name" : "我涯01",   
             "followCount":232,//关注数   
         "fansCount" :232//粉丝数   
          "aboutMe":"",介绍   
            "bFriend":1,//1为好友   
           "bSpecial":1,//1为特别关注   
           "bTwo":1,//1为互为关注   
              "remark":"小涯",//备注名称   
             "group":"23,23",//用户所在分组的id,用逗号隔开   
             "startype":1,//1为企业认证,2为微博v用户,3为手机绑定用户   
            "stardesc":,//相关类别下的star描述。(手机用户为空)   
              "starurl":"",//企业认证用户的url   
         }   
      ]   
    }   
  }          

PHP示例

SDK下载

include 'tyapi.php'; 
//参数设置 
$appkey=; 
$appsecret=;
$param['page'] = 1;
$param['pagesize'] = 10;
$url = 'http://open.tianya.cn/api/socialgraph/getfans.php';
$data = do_post($url,$appkey,$appsecret,$_SESSION["oauth_token"],$_SESSION["oauth_token_secret"],$param);
查看
个人工具
成功案例
帮助中心