接口地址
http://站点接口域名/api1_2/reports/index参数列表
@param int $uid 用户ID
@param int $year 年份（默认2017，则统计的是2017一整年数据）备注
1.单year参数填写在1000-2000数值之间，则是统计该用户截至今天的所有数据，而不是某一年的数据
2.无论统计的是具体年份还是用户整个使用期间，一旦生成，我们将以这个参数作为键值，把用户数据存储在数据库中，后期不会再重新生成，有新的数据产生也不会更新；比如year为1000，统计的是当前用户截至到现在的数据，在数据生成后有新的数据产生，只要year还是1000不变，数据也不会变，想要变可以再改成1001，不过请别滥用这个参数
3.建议站点获取到接口数据后，在本地以年份和用户ID做一份本地数据缓存
请求方式
POST返回值
ret
text
data array
username //亲爱的XXX
avatar //用户头像
reg_rank //你是第X位（按照用户id来判断，如果uid是1000,就是第1000位）
app_name //来到XXX APP的网友
reg_time //与我们一起走过了X天
assign_num //签到了多少天(如果有具体年份，则数据为一年内)
be_reward_cash //被打赏人民币个数(如果有具体年份，则数据为一年内)
be_reward_gold //被打赏金币个数(如果有具体年份，则数据为一年内)
reward_cash //打赏别人民币个数(如果有具体年份，则数据为一年内)
reward_gold //打赏别人金币个数(如果有具体年份，则数据为一年内)
cash_usage //消费人民币数目(如果有具体年份，则数据为一年内)
gold_usage //消费金币个数(如果有具体年份，则数据为一年内)
following_num //关注用户人数
be_followed_num //被关注用户数
join_tag_count //参与话题数目(如果有具体年份，则数据为一年内)
tag_x //最受欢迎的一个话题(如果有具体年份，则数据为一年内)
gold_name //站点自定义金币名称
key_word //关键词
key_desc //一句话描述
love_receive_num //被多少人喜欢
love_send_num //喜欢多少人
matched_num //交友配对成功
popular_side_id //最受欢迎的本地圈ID(如果有具体年份，则数据为一年内)
popular_side_title //最受欢迎本地圈内容（如果没有默认为 "图片分享"）(如果有具体年份，则数据为一年内)
popular_side_like_count //最受欢迎的本地圈被点赞数(如果有具体年份，则数据为一年内)
post_side_count //发表本地圈数目(如果有具体年份，则数据为一年内)
product_num //购买商品数
receive_gold //一共收获的金币数(如果有具体年份，则数据为一年内)
reward_cash //打赏人民币数(如果有具体年份，则数据为一年内)
reward_gold //打赏金币数(如果有具体年份，则数据为一年内)
side_reply_count //在X条本地圈下发表了自己的看法如果没有默认为 "图片分享"）(如果有具体年份，则数据为一年内)
share array
share_title 分享标题（可自定义，如果没有默认的就是用户名+的年报）
share_desc 分享描述（可自定义，默认为该用户18年一句话描述）
share_img 分享图片（该用户头像）
share_link 分享链接
bg_mp3 背景音乐（可自定义上传）返回值示例
{
ret: 0,
text: "",
data: {
username: "千帆小编",
avatar: "http://pic.app.qianfanyun.com/201801226151659292383368.jpg?imageslim|imageView2/1/w/100/h/100",
reg_rank: "6",
app_name: "千帆云",
reg_time: 437,
assign_num: "282",
be_reward_cash: "0",
be_reward_gold: "238",
cash_usage: "0.00",
following_num: "67",
be_followed_num:"1",
gold_usage: "350",
join_tag_count: "50+",
love_receive_num: "156",
love_send_num: "434",
matched_num: "4",
popular_side_id: "33797",
popular_side_like_count: "126",
popular_side_title: "#石首桃花季随手拍# 大片抢先看……图片来自@高歌@纳税光荣",
post_side_count: "317",
product_num: "",
receive_gold: "5963",
reward_cash: "0",
reward_gold: "832",
side_reply_count: "981",
gold_name: "千帆币",
key_word: "独立",
key_desc: "按照自己的想法去生活，不妥协，更出色。",
tag_x: "健身打卡",
share: {
share_title: "千帆小编的年报",
share_desc: "按照自己的想法去生活，不妥协，更出色。",
share_img: "http://pic.app.qianfanyun.com/201801226151659292383368.jpg?imageslim|imageView2/1/w/100/h/100",
share_link: "http://站点接口域名/wap/report/view-report?uid=2017",
bg_mp3: ""
}
}}
代码值示例
<?php
// 调用示例
$url = 'http://****************.**********.com/api1_2/reports/index'; //接口地址
$secret_key = '*************************8'; //站点密钥
$get_params = [];
$post_data = array(
'uid'=&34, //用户id
'year' =&2017, //年份，如果1000统计的是该用户注册至今的，其他如2017或2016就是一整年的
);
$ret = get_response($secret_key,$url, $get_params,$post_data);
print_r($ret);
function get_response($secret_key, $url, $get_params, $post_data = array())
{
$nonce = rand(10000, 99999);
$timestamp = time();
$array = array($nonce, $timestamp, $secret_key);
sort($array, SORT_STRING);
$token = md5(implode($array));
$params['nonce'] = $nonce;
$params['timestamp'] = $timestamp;
$params['token'] = $token;
$params = array_merge($params,$get_params);
$url .= '?';
foreach ($params as $k =& $v)
{
$url .= $k .'='. $v . '&';
}
$url = rtrim($url,'&');
// var_dump($url);exit;
$curlHandle = curl_init();
curl_setopt($curlHandle, CURLOPT_URL, $url); //需要获取的URL地址
curl_setopt($curlHandle, CURLOPT_HEADER, 0); //启用时会将头文件的信息作为数据流输出。
curl_setopt($curlHandle, CURLOPT_RETURNTRANSFER, 1); //将 curl_exec() 获取的信息以文件流的形式返回，而不是直接输出。
curl_setopt($curlHandle, CURLOPT_SSL_VERIFYPEER, false); //禁用后cURL将终止从服务端进行验证。
curl_setopt($curlHandle, CURLOPT_SSL_VERIFYHOST, FALSE); //1 检查服务器SSL证书中是否存在一个公用名(common name)。译者注：公用名(Common Name)一般来讲就是填写你将要申请SSL证书的域名 (domain)或子域名(sub domain)。2 检查公用名是否存在，并且是否与提供的主机名匹配。
curl_setopt($curlHandle, CURLOPT_POST, count($post_data)); //启用时会发送一个常规的POST请求
curl_setopt($curlHandle, CURLOPT_POSTFIELDS, $post_data); //数据使用HTTP协议中的"POST"操作来发送。
$data = curl_exec($curlHandle); //执行一个cURL会话
$status = curl_getinfo($curlHandle, CURLINFO_HTTP_CODE);
curl_close($curlHandle);
return $data;
}
?>文档更新时间: 2024-11-07 09:46 作者：张旭
