计算未来运行时间
正式API使用HTTPS和Bearer Token鉴权。密钥只在创建时完整显示一次，请勿写入前端代码或公开仓库。
POST https://cron.ciding.cc/api/v1/cron/next
Authorization: Bearer cron_live_xxxxxxxxx
Content-Type: application/json
{
"expression": "0 0 9 ? * MON-FRI",
"dialect": "quartz",
"timezone": "Asia/Shanghai",
"count": 10
}请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
expression | string | 必填，Cron表达式 |
dialect | string | quartz、spring、linux、node或auto |
timezone | string | IANA时区，例如Asia/Shanghai |
count | number | 返回次数，单次最多50条 |
from | string | 可选，ISO 8601起算时间 |
成功响应
{
"success": true,
"data": {
"expression": "0 0 9 ? * MON-FRI",
"dialect": "quartz",
"timezone": "Asia/Shanghai",
"description": "工作日上午 09:00:00 执行",
"next": [
{
"iso": "2026-07-30T09:00:00.000+08:00",
"local": "2026-07-30 09:00:00",
"weekday": "星期四"
}
]
}
}错误与额度
所有错误都返回稳定的错误码、可读消息和请求ID。可根据HTTP状态处理鉴权失败、额度用完、频率限制和表达式错误。
{
"success": false,
"error": {
"code": "CRON_EXPRESSION_INVALID",
"message": "星期字段格式无效"
},
"requestId": "req-..."
}公共网页工具永久免费。API是面向程序化、批量和商业系统的独立能力，不应通过抓取网页代替接口调用。
API套餐
| 套餐 | 月费 | 月调用量 | 适合场景 |
|---|---|---|---|
| 入门版 | ¥6.90 | 2,000次 | 个人工具与小型应用 |
| 专业版 | ¥19.90 | 20,000次 | 业务系统与自动化平台 |
| 商业版 | ¥49.90 | 100,000次 | 多项目或团队集成 |
套餐支持在线购买。每次购买会从购买时刻重新计算30天有效期并重置为新套餐额度；当前套餐未用完的额度不会叠加，请在付款前确认。
接入安全建议
- API Key仅保存在服务端环境变量或密钥管理服务中。
- 不要将密钥写入浏览器JavaScript、移动端安装包或公开日志。
- 为不同项目创建不同密钥，泄露时只撤销受影响的密钥。
- 缓存重复表达式的解析结果，减少额度消耗和网络延迟。