短网址
把长网址生成本站短链,默认 30 天有效。用户点开自动跳转并统计点击,点击不扣次数。
POST JSON 传入 url,可选 expire_days(默认 30,最大 365)。
生成成功返回 short_url、code、expire_at。
访问短链会 302 跳转到原网址并累计点击,不消耗套餐次数。
点击次数在登录后的「个人中心 → 我的短链」查看;也可打开 short_url?info=1 用 JSON 查询。
生成成功返回 short_url、code、expire_at。
访问短链会 302 跳转到原网址并累计点击,不消耗套餐次数。
点击次数在登录后的「个人中心 → 我的短链」查看;也可打开 short_url?info=1 用 JSON 查询。
调用地址:https://api.ynlskj.com.cn/gateway/shorturl
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
url |
Body JSON | 是 | 要缩短的长网址,须为 http 或 https。也可用 long_url。可省略 https:// |
expire_days |
Body JSON | 否 | 有效天数,默认 30,范围 1–365 |
from |
Body JSON | 否 | 投放来源,如 taobao、dy。也可用 source |
X-API-Key |
Header | 是 | 你的 API Key(请求头,不要放进网址或 Query) |
请求示例
| 场景 | Body 示例 |
|---|---|
| 默认 30 天 | {"url":"https://www.example.com"} |
| 淘宝投放 | {"url":"https://www.example.com","from":"taobao"} |
| 抖音投放 | {"url":"https://www.example.com","from":"dy"} |
点击次数和来源在哪里看
- 生成时把
from传进去,会扣 1 次套餐次数,得到干净短链(形如https://api.ynlskj.com.cn/s.php/短码),不用再拼参数 - 同一个长链要投多个渠道,就生成多条短链,每条换一个
from - 用户点开这条短链会跳转并记到对应来源,点击不扣次数
- 登录后打开「个人中心 → 我的短链」,可以看到每条短链绑定的来源和点击次数
- 程序里也可以访问
短链?info=1拿 JSON,不消耗套餐次数,也不会算一次点击
常用来源码
| from | 渠道 |
|---|---|
taobao | 淘宝 |
dy | 抖音 |
wx | 微信 |
xhs | 小红书 |
ks | 快手 |
jd | 京东 |
也可以自己定义,如 live01,字母数字下划线即可。不传 from 则记为「未区分」。
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.short_url | 可直接发给用户的短链,干净地址,不用再拼参数 |
data.code | 短码 |
data.url | 规范化后的原网址 |
data.from | 生成时绑定的来源码,如 taobao。未传则为 direct |
data.from_name | 来源中文名,如淘宝 |
data.expire_days | 本次有效天数 |
data.expire_at | 到期时间 |
data.hits | 当前点击次数,刚生成时为 0 |
data.stats_url | 查询点击的 JSON 地址,访问它不扣次数、不加点击 |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/shorturl');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"url": "https://www.example.com",
"from": "taobao"
}',
]);
echo curl_exec($ch);
请求参数演示
{"url":"https://www.example.com"}
响应演示
{"ret":"ok","data":{"code":"a8Kx2pQ","short_url":"https://api.ynlskj.com.cn/s/a8Kx2pQ","url":"https://www.example.com","expire_days":30,"expire_at":"2026-09-17 13:00:00","hits":0,"stats_url":"https://api.ynlskj.com.cn/s/a8Kx2pQ?info=1","expired":false}}