定时URL调用
定时 URL 调用:GET/POST 传参,按分/时/天自动请求你的接口
定时 URL 调用:按分钟/小时/天自动向指定地址发起 GET 或 POST 请求,支持传参(Query / Form / JSON)。
管理与配置免费;每次真实 HTTP 调用扣 1 次套餐。支持立即试调。禁止访问内网地址。
管理与配置免费;每次真实 HTTP 调用扣 1 次套餐。支持立即试调。禁止访问内网地址。
调用地址:https://api.ynlskj.com.cn/gateway/urlcron
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
action | Body JSON | 是 | create / update / list / status / pause / resume / delete;run_now 立即调用 |
url | Body JSON | create 时 | 目标地址,http/https 公网,禁止内网 |
method | Body JSON | 否 | GET(默认)或 POST |
body_type | Body JSON | 否 | query(拼 URL)/ form(POST 表单)/ json(POST JSON)。GET 固定 query |
params | Body JSON | 否 | 键值对象,如 {"a":"1","b":"2"} |
headers | Body JSON | 否 | 自定义请求头对象(可选) |
freq_unit / freq_every | Body JSON | create 时 | 频率:minute/hour/day + 每 N 个单位 |
times | Body JSON | 否 | 调用次数上限,0 不限,最大 1000 |
job_id | Body JSON | 管理/立即调用时 | 任务 ID,格式 uc_xxx |
X-API-Key | Header | 是 | 你的 API Key |
这个接口是干什么的?
把「定时请求某个 URL」做成 API:配置目标地址、GET/POST、传参与频率,平台按计划代你发起 HTTP 请求,无需自建 cron。
典型场景:定时回调、心跳探活、同步第三方、周期性触发业务接口。也可在「个人中心 → 定时 URL 调用」可视化管理。
计费说明
- 免费:创建/改/暂停/查询任务等管理调用
- 扣次:每次真实 HTTP 调用(含定时执行与
run_now)扣 1 次 - 次数不足时任务会自动暂停,并写入错误「次数不足」
怎么用
- 准备好可公网访问的目标 URL
- 调用
create配置 method、params、频率 - 用
run_now立即试调一次,确认对方收到
请求示例
| 场景 | Body 示例 |
|---|---|
| 每小时 POST JSON | {"action":"create","url":"https://example.com/api/ping","method":"POST","body_type":"json","params":{"token":"xxx"},"freq_unit":"hour","times":0} |
| 每 5 分钟 GET | {"action":"create","url":"https://example.com/hook","method":"GET","params":{"from":"ynls"},"freq_unit":"minute","freq_every":5} |
| 立即调用任务 | {"action":"run_now","job_id":"uc_xxx"} |
| 临时试调 | {"action":"run_now","url":"https://example.com/hook","method":"POST","body_type":"form","params":{"a":"1"}} |
| 暂停 / 恢复 | {"action":"pause","job_id":"uc_xxx"} / {"action":"resume","job_id":"uc_xxx"} |
说明与限制
- 仅允许公网 http/https;拒绝 localhost、内网 IP、裸 IP 及解析到内网的域名(防 SSRF)
- 不跟随重定向;超时约 15 秒;活跃任务 ≤ 20;最短间隔 1 分钟
- 调度依赖现有队列 cron(每分钟)
- 也可在「个人中心 → 定时 URL 调用」可视化配置参数
- 风控:账号/任务/全站限速;域名黑名单(可在
config/urlcron_blacklist.php追加);连续失败自动暂停;调用日志含目标域名便于审计
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.job_id | 定时任务 ID,格式 uc_xxx |
data.url / method / body_type | 目标地址与请求方式 |
data.params / headers | 传参与自定义头 |
data.status / next_run_at | 状态与下次执行时间 |
data.http_status / response / deducted | 立即调用时的 HTTP 状态、响应摘要、扣次 |
data.recent_logs | status 时最近调用日志 |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/urlcron');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"action": "create",
"name": "每小时心跳",
"url": "https://example.com/api/ping",
"method": "POST",
"body_type": "json",
"params": {
"token": "xxx",
"source": "ynls"
},
"freq_unit": "hour",
"freq_every": 1,
"times": 0
}',
]);
echo curl_exec($ch);
请求参数演示
{"action":"create","name":"每小时心跳","url":"https://example.com/api/ping","method":"POST","body_type":"json","params":{"token":"xxx","source":"ynls"},"freq_unit":"hour","freq_every":1,"times":0}
响应演示
{"ret":"ok","data":{"action":"create","job_id":"uc_xxxxxxxxxxxxxxxxxxxxxxxx","status":"active","method":"POST","url":"https://example.com/api/ping","next_run_at":"2026-08-29 16:27:37"}}