定时URL调用

定时 URL 调用:GET/POST 传参,按分/时/天自动请求你的接口

定时 URL 调用:按分钟/小时/天自动向指定地址发起 GET 或 POST 请求,支持传参(Query / Form / JSON)。
管理与配置免费;每次真实 HTTP 调用扣 1 次套餐。支持立即试调。禁止访问内网地址。

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

请求方法:POST

在其他地方怎么调用

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

参数说明

参数位置必填说明
actionBody JSONcreate / update / list / status / pause / resume / deleterun_now 立即调用
urlBody JSONcreate 时目标地址,http/https 公网,禁止内网
methodBody JSONGET(默认)或 POST
body_typeBody JSONquery(拼 URL)/ form(POST 表单)/ json(POST JSON)。GET 固定 query
paramsBody JSON键值对象,如 {"a":"1","b":"2"}
headersBody JSON自定义请求头对象(可选)
freq_unit / freq_everyBody JSONcreate 时频率:minute/hour/day + 每 N 个单位
timesBody JSON调用次数上限,0 不限,最大 1000
job_idBody JSON管理/立即调用时任务 ID,格式 uc_xxx
X-API-KeyHeader你的 API Key

这个接口是干什么的?

把「定时请求某个 URL」做成 API:配置目标地址、GET/POST、传参与频率,平台按计划代你发起 HTTP 请求,无需自建 cron。

典型场景:定时回调、心跳探活、同步第三方、周期性触发业务接口。也可在「个人中心 → 定时 URL 调用」可视化管理。

计费说明

  • 免费:创建/改/暂停/查询任务等管理调用
  • 扣次:每次真实 HTTP 调用(含定时执行与 run_now)扣 1 次
  • 次数不足时任务会自动暂停,并写入错误「次数不足」

怎么用

  1. 准备好可公网访问的目标 URL
  2. 调用 create 配置 method、params、频率
  3. 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 追加);连续失败自动暂停;调用日志含目标域名便于审计

返回说明

字段说明
retok 成功,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_logsstatus 时最近调用日志
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"}}

在线调试

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

去登录