二维码活码
二维码活码:固定二维码入口,可随时改跳转地址,支持访问上限与渠道统计
二维码活码:生成一次二维码后,入口地址固定不变,可在后台随时修改跳转目标,无需重印物料。
支持:访问次数上限、过期时间、多渠道来源统计(投放链接加 ?from=dy 等)。
扫码跳转按次扣费(每次有效扫码扣 1 次);创建、查询、统计等 API 调用免费;修改跳转地址免费。
Phase 2:访问明细(保留约 30 天)、按日汇总、自定义暂停/过期落地页、stats 统计接口。
支持:访问次数上限、过期时间、多渠道来源统计(投放链接加 ?from=dy 等)。
扫码跳转按次扣费(每次有效扫码扣 1 次);创建、查询、统计等 API 调用免费;修改跳转地址免费。
Phase 2:访问明细(保留约 30 天)、按日汇总、自定义暂停/过期落地页、stats 统计接口。
调用地址:https://api.ynlskj.com.cn/gateway/livecode
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
action | Body JSON | 是 | create 创建、update 改跳转、status 查询、list 列表、stats 统计明细、pause / resume 停启、delete 删除、qrcode 换样式 |
target_url | Body JSON | create 时 | 当前跳转地址,http/https 公网网址 |
name | Body JSON | 否 | 活码备注名称,便于管理 |
expire_days | Body JSON | 否 | 有效天数,默认 30,最大 365 |
max_visits | Body JSON | 否 | 访问上限,0 表示不限 |
default_source | Body JSON | 否 | 默认渠道,如 dy / wx / taobao |
qr_style | Body JSON | 否 | classic / rounded / elegant / mint,默认 elegant |
qr_label | Body JSON | 否 | 二维码下方文字 |
pause_title | Body JSON | 否 | 暂停/过期/达上限时的落地页标题 |
pause_message | Body JSON | 否 | 暂停/过期/达上限时的说明文字 |
pause_url | Body JSON | 否 | 暂停/过期/达上限时优先 302 跳转的备用地址 |
from / to | Body JSON | stats 时否 | 统计日期区间 YYYY-MM-DD,默认近 7 天,最长 90 天 |
source | Body JSON | stats 时否 | 按渠道筛选明细,如 dy / wx |
page / per_page | Body JSON | stats 时否 | 访问明细分页,per_page 最大 50 |
code_id | Body JSON | 管理时 | 活码 ID,格式 lc_xxx。也可用 code |
X-API-Key | Header | 是 | 你的 API Key |
怎么用(3 步上手)
- 创建活码:调用
action=create,拿到固定的entry_url和qr_image - 印刷 / 投放:把二维码印到海报,或把入口链接发到各渠道(可加
?from=dy区分来源) - 随时改跳转:活动页换了只调
action=update改target_url,二维码不用重印
请求示例
| 场景 | Body 示例 |
|---|---|
| 创建活码 | {"action":"create","target_url":"https://你的域名.com/活动页","name":"海报A","expire_days":30,"max_visits":1000} |
| 修改跳转(免费) | {"action":"update","code_id":"lc_xxx","target_url":"https://你的域名.com/新活动"} |
| 抖音渠道投放 | 入口链接:https://api.ynlskj.com.cn/l/Ab3xK9?from=dy(二维码仍用无参入口即可) |
| 查询统计 | {"action":"status","code_id":"lc_xxx"} |
| 访问明细 | {"action":"stats","code_id":"lc_xxx","from":"2026-08-01","to":"2026-08-23","source":"dy"} |
| 自定义暂停页 | {"action":"update","code_id":"lc_xxx","pause_title":"活动已结束","pause_message":"感谢参与","pause_url":"https://你的域名.com/end"} |
| 暂停 / 恢复 | {"action":"pause","code_id":"lc_xxx"} / {"action":"resume","code_id":"lc_xxx"} |
计费说明
- 扣次:用户扫码跳转,每次有效访问扣 1 次(在后台「套餐」中为「二维码活码」配置次数包)
- 免费:create、update、status、list、stats、qrcode、pause、resume、delete 等 API 调用
- 次数用完时扫码会提示「活码暂不可用」,续费套餐后恢复
- 每账号最多 50 个活跃活码(active + paused)
- 也可在「个人中心 → 我的活码」免费改跳转地址
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.code_id | 活码 ID,格式 lc_xxx |
data.entry_url | 固定入口,印到二维码里 |
data.target_url | 当前跳转地址,可随时 update 修改 |
data.qr_image | create / qrcode 返回,PNG 格式 Data URI(data:image/png;base64,...),可直接用于 img 或下载 |
data.qr_format | 二维码图片格式,固定为 png |
data.svg | 同内容的 SVG 源码(含 qr_label 文字,便于预览) |
data.visits / max_visits | 已访问次数 / 上限(0 为不限) |
data.sources | status / stats 时返回各渠道点击:from、name、hits |
data.channel_links | 各渠道投放链接(带 ?from= 参数) |
data.days | stats 时按日汇总:[{day, visits}, ...] |
data.recent_hits | stats 时访问明细:from、ip、ua、time 等 |
data.pause_title / pause_message / pause_url | 暂停/过期/达上限时的自定义落地页 |
data.stats_url | 公开统计 JSON:entry_url?info=1 |
data.status | active / paused / expired / exhausted |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/livecode');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"action": "create",
"target_url": "https://api.ynlskj.com.cn",
"name": "双十一海报",
"expire_days": 30,
"max_visits": 1000,
"qr_style": "elegant"
}',
]);
echo curl_exec($ch);
请求参数演示
{"action":"create","target_url":"https://api.ynlskj.com.cn","name":"双十一海报","expire_days":30,"max_visits":1000,"qr_style":"elegant","qr_label":"扫码领券"}
响应演示
{"ret":"ok","data":{"action":"create","code_id":"lc_xxxxxxxxxxxxxxxxxxxxxxxx","code":"Ab3xK9m","entry_url":"https://api.ynlskj.com.cn/l/Ab3xK9m","target_url":"https://api.ynlskj.com.cn","status":"active","max_visits":1000,"visits":0,"expire_at":"2026-09-22 12:00:00","qr_image":"data:image/png;base64,..."}}