接口地址

http://{hostname}.qianfanapi.com/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://qianfanyun.qianfanapi.com/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 . '&amp;';
        }
        $url = rtrim($url,'&amp;');
        // 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;
    }

?>
文档更新时间: 2019-12-31 15:38   作者:张旭