流量统计
统计网页、小程序、App、软件的 PV、UV 和访客 IP。前端打点不扣次,查询按次计费。
网页嵌入 yn-stat.js 即可采集,小程序/App 向 /t.php POST JSON。
查询 API:action=summary / visitors / sites。
采集和报表要求套餐未过期,查询才扣次数。
查询 API:action=summary / visitors / sites。
采集和报表要求套餐未过期,查询才扣次数。
调用地址:https://api.ynlskj.com.cn/gateway/traffic
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
action | Body JSON | 否 | summary 按日汇总(默认),visitors 最近访客,sites 站点列表 |
site_id | Body JSON | 查汇总/访客时是 | 个人中心创建站点后得到的 ID |
from / to | Body JSON | 否 | summary 的日期范围,默认近 7 天,最多 90 天 |
day | Body JSON | 否 | visitors 查询哪一天,默认今天 |
page | Body JSON | 否 | 访客列表页码,默认 1 |
X-API-Key | Header | 是 | 你的 API Key |
怎么接入采集
前端打点走独立地址 https://api.ynlskj.com.cn/t.php,不扣次数,也不要把 API Key 写进网页或小程序。先在「个人中心 → 流量统计」创建站点,拿到 site_id 和采集令牌。
| 场景 | 接入方式 |
|---|---|
| 网页 | <script src="https://api.ynlskj.com.cn/assets/yn-stat.js" data-sid="站点ID" data-tk="采集令牌"></script> |
| 小程序 / App / 软件 | 向采集地址 POST JSON:{"sid":"站点ID","tk":"采集令牌","vid":"设备或用户ID","path":"/home","platform":"mp"} |
查询示例
| 场景 | Body 示例 |
|---|---|
| 近 7 日汇总 | {"action":"summary","site_id":"你的站点ID"} |
| 指定日期 | {"action":"summary","site_id":"你的站点ID","from":"2026-08-01","to":"2026-08-22"} |
| 当天访客 | {"action":"visitors","site_id":"你的站点ID","day":"2026-08-22"} |
| 我的站点 | {"action":"sites"} |
UV 按同一站点、同一天、同一 vid 去重。网页脚本会自动生成并保存访客 ID;不传 vid 时用 IP+UA 的日哈希兜底,UV 会偏少。原始访问保留 14 天,日汇总长期保留。
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.pv / uv / ip_count | summary 区间内的浏览量、独立访客、独立 IP |
data.days | 按日数组:day / pv / uv / ip_count |
data.items | visitors 的访客列表:ip、path、platform、time |
data.sites | sites 时的站点列表,token 只回后 4 位 |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/traffic');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"action": "summary",
"site_id": "你的站点ID",
"from": "2026-08-16",
"to": "2026-08-22"
}',
]);
echo curl_exec($ch);
请求参数演示
{"action":"summary","site_id":"你的站点ID","from":"2026-08-16","to":"2026-08-22"}
响应演示
{"ret":"ok","code":200,"errmsg":"成功","data":{"action":"summary","site_id":"ab12cd34ef","from":"2026-08-16","to":"2026-08-22","pv":1280,"uv":356,"ip_count":310,"days":[{"day":"2026-08-22","pv":180,"uv":62,"ip_count":58}]}}