PHP 调用微信数据统计接口方法详解

接口概述与注意事项

微信公众平台提供的数据统计接口用于获取公众平台官网数据统计模块中的用户分析数据。在调用前需注意以下关键限制：

• 数据时效性：公众号数据库仅存储 2014-12-01 之后的数据，此前日期查询不到或数据不可信。
• 缓存建议：获取数据后应保存至自有数据库，以提升访问速度并降低微信侧接口调用损耗。
• 最大时间跨度：单次接口调用可获取的最大数据范围有限（如部分接口为7天），需合理规划请求频率。

接口调用准备

所有用户分析数据接口均需通过 POST 方式向相应地址发送数据包，核心参数为开始日期与结束日期：

{
  "begin_date": "2014-12-02",
  "end_date": "2014-12-07"
}

第1步：扩展接口常量定义

若使用现有的微信高级接口类，需新增数据立方（datacube）相关的常量标识：

API_DATA_CUBE_URL = 'https://api.weixin.qq.com/datacube',
API_TYPE_DATA = 'datacube'

第2步：修改请求构建逻辑

在类的 call 方法中引入 switch 判断，区分不同 API 类型。针对数据立方接口，URL 拼接需包含 access_token 作为查询参数：

public function call($api_name, $params = array(), $type = self::GET, $api_type = self::API_TYPE_CGI) {
    // 根据类型组装基础 URL
    switch(true) {
      case $api_type == self::API_TYPE_PAY :
        $url = self::PAY_URL.$api_name;
        break;
      case $api_type == self::API_TYPE_DATA:
        $url = self::API_DATA_CUBE_URL.$api_name;
        break;
      default :
        $url = self::API_URL_PREFIX.$api_name;
    }
    
    // 处理不需要 Token 的接口
    if (in_array($api_name, self::$_no_need_token_apis)) {
      $res = $this->request($url, $params, $type);
      if ($res) return $res;
    }
    
    // 获取并附加 access_token
    $this->_access_token = $this->getAccessToken();
    if ($this->_access_token) {
      // 对于 JSON POST 或 datacube 类型，token 拼在 URL 中
      if ($type == self::JSON || $api_type == self::API_TYPE_DATA) {
        $url = $url.'?access_token='.$this->_access_token;
      } else {
        $params['access_token'] = $this->_access_token;
      }
      $res = $this->request($url, $params, $type);
      if ($res) return $res;
    }
    return false;
}

第3步：执行接口调用测试

可通过命令行工具调用 /getinterfacesummary 接口进行调试。注意指定 WechatJSON::POST 和 WechatJSON::API_TYPE_DATA 类型：

if (isset($argc) && $argc >= 1 && $argv[0] == __FILE__) {
  $client = new WechatJSON(array(
    WechatJSON::APP_ID => 'your_app_id',
    WechatJSON::APP_SECRET => 'your_app_secret',
  ));
  $res = $client->call('/getinterfacesummary', array(
    'begin_date' => '2014-12-01',
    'end_date' => '2014-12-31'
  ), WechatJSON::POST, WechatJSON::API_TYPE_DATA);
  
  if (!$res) {
    var_dump($client->_error);
  } else {
    var_dump($res);
  }
}

若返回 API 未授权 错误，通常因该接口属于内测或有条件开放，需确保账号具备相应权限。建议后续配置定时任务自动拉取数据存入库表，以便生成可视化报表。