Cron 表达式解析
正常 NEW5 段 crontab 表达式解析 / 校验 / 中文描述 / 未来 N 次执行时间 / 过去 N 次执行时间 / 指定时刻匹配。严格 Vixie cron 语义, 纯离线计算, 时区 Asia/Shanghai。
¥
0.002
/ 次
按次计费
健康检查 。
健康检查 。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/cron/ping
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.version | string | - |
| data.time | string | - |
请求示例
返回示例
{"msg":"pong","code":0,"data":{"time":"2026-11-03 00:53:44","version":"1.0"}}
字段/语法/宏说明 。
字段/语法/宏说明 。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/cron/fields
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.fields | array | - |
| data.macros | object | - |
| data.semantics | string | - |
| data.timezone | string | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"fields":[{"cn":"分钟","name":"minute","range":"0-59","position":1}],"macros":{"@daily":"0 0 * * *"},"timezone":"Asia/Shanghai","semantics":"..."}}
表达式解析与中文描述。Body: {"expression": "30 8 *
表达式解析与中文描述。Body: {"expression": "30 8 * * 1-5"}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/cron/parse
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| expression | string | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.expression | string | - |
| data.description | string | - |
| data.sets | object | - |
| data.dom_star | bool | - |
| data.dow_star | bool | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"sets":{"dom":[1,2],"dow":[1,2,3,4,5],"hour":[8],"month":[1],"minute":[30]},"dom_star":false,"dow_star":false,"expression":"30 8 * * 1-5","description":"周一至周五 每天 08:30"}}
未来 N 次执行时间。Body: {"expression": "30 8 *
未来 N 次执行时间。Body: {"expression": "30 8 * * 1-5", "count": 3, "start": "2026-11-01 10:07:00"}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/cron/next
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| expression | string | 是 | - |
| count | int | 是 | - |
| start | string | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.expression | string | - |
| data.description | string | - |
| data.count | int | - |
| data.list | array | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"list":[{"time":"2026-11-02 08:30:00","timestamp":1793656200}],"count":3,"expression":"30 8 * * 1-5","description":"周一至周五 每天 08:30"}}
指定时刻匹配判定。Body: {"expression": "*/15 * *
指定时刻匹配判定。Body: {"expression": "*/15 * * * *", "time": "2026-11-01 10:15:00"}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/cron/match
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| expression | string | 是 | - |
| time | string | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.expression | string | - |
| data.time | string | - |
| data.timestamp | int | - |
| data.matched | bool | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"time":"2026-11-01 10:15:00","matched":true,"timestamp":1793499300,"expression":"*/15 * * * *"}}
过去 N 次执行时间 (不含 end 所在分钟)。Body: {"express
过去 N 次执行时间 (不含 end 所在分钟)。Body: {"expression": "0 0 * * *", "count": 3, "end": "2026-11-02 00:00:00"}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/cron/prev
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| expression | string | 是 | - |
| count | int | 是 | - |
| end | string | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.expression | string | - |
| data.description | string | - |
| data.count | int | - |
| data.list | array | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"list":[{"time":"2026-11-01 00:00:00","timestamp":1793462400},{"time":"2026-10-31 00:00:00","timestamp":1793376000},{"time":"2026-10-30 00:00:00","timestamp":1793289600}],"count":3,"expression":"0 0 * * *","description":"每天 00:00"}}
产品说明
产品概述
5 段 crontab 表达式解析 / 校验 / 中文描述 / 未来 N 次执行时间 / 过去 N 次执行时间 / 指定时刻匹配。严格 Vixie cron 语义, 纯离线计算, 时区 Asia/Shanghai。
使用场景
数据查询：快速集成 Cron 表达式解析 到您的应用中
业务系统：将 Cron 表达式解析 数据嵌入业务流程
开发工具：通过 API 接口获取 开发工具 数据
数据分析：基于 Cron 表达式解析 数据进行分析和决策
费用计算
按次计费单价
¥0.002
/ 次
每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣
扣费优先级
免费额度
次数包
余额扣费
计费方式详解
1
免费额度
· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
2
次数包
预付费购买固定调用次数，折算单价与按次付费相同，用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
3
余额扣费
按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣： 个人版9折 专业版8折 企业版7折
量折扣： 月付费调用 ≥1000 次享 2%、 月付费调用 ≥10000 次享 5%、 月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣： 个人版9折 专业版8折 企业版7折
量折扣： 月付费调用 ≥1000 次享 2%、 月付费调用 ≥10000 次享 5%、 月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
VIP 权益对比
| 等级 | 每月免费次数 | 本接口月免费上限 | 折扣 | VIP 折后单价 |
|---|---|---|---|---|
| 免费版 | 按接口配置 | — | - | ¥0.002/次 |
| 个人版 | 5000 次 | 5000 次 | 10% | ¥0.0018/次 |
| 专业版 | 30000 次 | 30000 次 | 20% | ¥0.0016/次 |
| 企业版推荐 | 200000 次 | 200000 次 | 30% | ¥0.0014/次 |
* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。
本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。
费用计算示例
* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。
示例1：普通用户按次付费
调用 1000 次，费用 = 0.002 × 1000 = ¥2.00
示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）
调用 1000 次，折扣约 10%，费用 = 0.002 × (1 - 10%) × 1000 ≈ ¥1.80
错误码说明
本接口未定义专属错误码，调用时请参考通用错误码体系。
查看通用错误码参考
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 200 | 请求成功 | - |
| 400000 | 请求参数错误 | 检查参数名、格式与取值 |
| 401000 | 认证失败 | 检查 Authorization: Bearer 密钥是否正确、是否过期 |
| 401002 | 缺少 API 认证参数 | 请求未携带 key，请通过 URL 参数 key 或请求头 Authorization 传递密钥 |
| 402000 | 账户余额不足 | 充值后重试 |
| 403000 | 无访问权限 | 确认密钥权限、接口范围与 IP 白名单是否满足要求 |
| 404001 | 接口或端点不存在 | 检查 API 与端点的请求路径 |
| 409000 | 请求冲突 | 请稍后重试 |
| 422000 | 参数校验失败 | 检查参数格式与取值 |
| 429001 | 请求频率超限（QPS） | 降低请求频率，或升级套餐提升额度 |
| 429002 | 分钟级调用频率超限 | 降低调用频率，或升级套餐提升额度 |
| 429003 | 小时级调用额度已用完 | 升级套餐提升额度，或整点后重试 |
| 429004 | 今日调用额度已用完 | 升级套餐提升额度，或次日重试 |
| 500000 | 服务器内部错误 | 携带响应中的 request_id 联系技术支持 |
| 502000 | 服务暂时不可用 | 稍后重试 |
| 503000 | 服务暂时不可用 | 稍后重试 |
| 504000 | 请求超时 | 稍后重试 |
更新日志
暂无更新日志