流量统计

统计网页、小程序、App、软件的 PV、UV 和访客 IP。前端打点不扣次,查询按次计费。

网页嵌入 yn-stat.js 即可采集,小程序/App 向 /t.php POST JSON。
查询 API:action=summary / visitors / sites。
采集和报表要求套餐未过期,查询才扣次数。

调用地址:https://api.ynlskj.com.cn/gateway/traffic

请求方法:POST

在其他地方怎么调用

  1. 请求地址用上面的调用地址,把 JSON 放在请求体里
  2. 方法用 POST
  3. API Key 只能放在请求头 X-API-Key,不要写进网址,也不要写进 Query 框
  4. Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key

参数说明

参数位置必填说明
actionBody JSONsummary 按日汇总(默认),visitors 最近访客,sites 站点列表
site_idBody JSON查汇总/访客时是个人中心创建站点后得到的 ID
from / toBody JSONsummary 的日期范围,默认近 7 天,最多 90 天
dayBody JSONvisitors 查询哪一天,默认今天
pageBody JSON访客列表页码,默认 1
X-API-KeyHeader你的 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 天,日汇总长期保留。

返回说明

字段说明
retok 成功,err 失败
data.pv / uv / ip_countsummary 区间内的浏览量、独立访客、独立 IP
data.days按日数组:day / pv / uv / ip_count
data.itemsvisitors 的访客列表:ip、path、platform、time
data.sitessites 时的站点列表,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}]}}

在线调试

登录后可在线调试。调试会真实调用网关并消耗次数。

去登录