二维码活码

二维码活码:固定二维码入口,可随时改跳转地址,支持访问上限与渠道统计

二维码活码:生成一次二维码后,入口地址固定不变,可在后台随时修改跳转目标,无需重印物料。

支持:访问次数上限、过期时间、多渠道来源统计(投放链接加 ?from=dy 等)。
扫码跳转按次扣费(每次有效扫码扣 1 次);创建、查询、统计等 API 调用免费;修改跳转地址免费。
Phase 2:访问明细(保留约 30 天)、按日汇总、自定义暂停/过期落地页、stats 统计接口。

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

请求方法:POST

在其他地方怎么调用

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

参数说明

参数位置必填说明
actionBody JSONcreate 创建、update 改跳转、status 查询、list 列表、stats 统计明细、pause / resume 停启、delete 删除、qrcode 换样式
target_urlBody JSONcreate 时当前跳转地址,http/https 公网网址
nameBody JSON活码备注名称,便于管理
expire_daysBody JSON有效天数,默认 30,最大 365
max_visitsBody JSON访问上限,0 表示不限
default_sourceBody JSON默认渠道,如 dy / wx / taobao
qr_styleBody JSONclassic / rounded / elegant / mint,默认 elegant
qr_labelBody JSON二维码下方文字
pause_titleBody JSON暂停/过期/达上限时的落地页标题
pause_messageBody JSON暂停/过期/达上限时的说明文字
pause_urlBody JSON暂停/过期/达上限时优先 302 跳转的备用地址
from / toBody JSONstats 时否统计日期区间 YYYY-MM-DD,默认近 7 天,最长 90 天
sourceBody JSONstats 时否按渠道筛选明细,如 dy / wx
page / per_pageBody JSONstats 时否访问明细分页,per_page 最大 50
code_idBody JSON管理时活码 ID,格式 lc_xxx。也可用 code
X-API-KeyHeader你的 API Key

怎么用(3 步上手)

  1. 创建活码:调用 action=create,拿到固定的 entry_urlqr_image
  2. 印刷 / 投放:把二维码印到海报,或把入口链接发到各渠道(可加 ?from=dy 区分来源)
  3. 随时改跳转:活动页换了只调 action=updatetarget_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)
  • 也可在「个人中心 → 我的活码」免费改跳转地址

返回说明

字段说明
retok 成功,err 失败
data.code_id活码 ID,格式 lc_xxx
data.entry_url固定入口,印到二维码里
data.target_url当前跳转地址,可随时 update 修改
data.qr_imagecreate / qrcode 返回,PNG 格式 Data URI(data:image/png;base64,...),可直接用于 img 或下载
data.qr_format二维码图片格式,固定为 png
data.svg同内容的 SVG 源码(含 qr_label 文字,便于预览)
data.visits / max_visits已访问次数 / 上限(0 为不限)
data.sourcesstatus / stats 时返回各渠道点击:from、name、hits
data.channel_links各渠道投放链接(带 ?from= 参数)
data.daysstats 时按日汇总:[{day, visits}, ...]
data.recent_hitsstats 时访问明细:from、ip、ua、time 等
data.pause_title / pause_message / pause_url暂停/过期/达上限时的自定义落地页
data.stats_url公开统计 JSON:entry_url?info=1
data.statusactive / 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,..."}}

在线调试

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

去登录