数据接口文档：用 API 读取网站统计数据

面向站长获客软件 / AI 大模型 / 第三方系统的数据接口。签名鉴权，JSON 返回，全部调用写入审计日志。

一、签名鉴权

签名 = sha256( 时间戳 . 站点密钥 )

• 时间戳：当前 Unix 时间戳（秒），与服务器时间差 ≤ 300 秒有效
• 站点密钥：面板站点页显示的 xk_ 开头密钥，不要暴露在前端页面

请求头名必须用 ASCII 英文。HTTP 标准禁止非 ASCII 头名，中文头名在真实客户端会被拒绝。

PHP 示例

$站点编号 = 1;
$站点密钥 = 'xk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
$时间戳   = time();
$签名     = hash('sha256', $时间戳 . $站点密钥);

$url = "https://js.7w4.net/api.php?动作=核心指标"
     . "&站点编号=$站点编号&时间戳=$时间戳&签名=$签名"
     . "&起始日期=2026-09-01&结束日期=2026-09-10";
$数据 = json_decode(file_get_contents($url), true);

Python 示例

import time, hashlib, requests

站点编号, 站点密钥 = 1, "xk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
时间戳 = int(time.time())
签名 = hashlib.sha256(f"{时间戳}{站点密钥}".encode()).hexdigest()

resp = requests.get("https://js.7w4.net/api.php", params={
    "动作": "AI报告", "站点编号": 站点编号,
    "时间戳": 时间戳, "签名": 签名,
    "起始日期": "2026-09-01", "结束日期": "2026-09-10",
})
print(resp.json())

二、返回格式

{"状态":"成功","数据":{ ... }}
{"状态":"错误","消息":"签名校验失败（时间戳超时或签名错误）"}

三、动作清单

所有动作都支持 起始日期 / 结束日期（YYYY-MM-DD），省略默认今日。

四、限流

• 每 IP 每秒 ≤ 10 次
• 每站每秒 ≤ 200 次
• 超限返回 429「访问过于频繁」

五、最佳实践