克龙鲁姆
- V1级专业

建造、运行和回收
API的每个头饰。

为专业克龙操作提供完整的参考和现场测试控制台. 连接专用的 API 密钥, 编辑真实参数并检查您的 CronLume 工作空间返回的确切响应 。

25 记录操作贾森 请求和答复机构守护者 认证
生产基址https://api.cronlume.com/v1总部Authorization: Bearer crl_live_…

密钥在 磁盘- API 密钥.

⌁
生活安乐

连接您的 API 密钥

密钥会留在此页面的内存中, 只发送到您明确测试的终点 。 它从未被添加到实例, URL 或浏览器存储中.

未连接
APIDMAIN (英语).

认证

校验证书并识别活动的工作空间 。

获取/account

校验 API 连接

验证 Bearer 密钥,并返回认证的 API- key 身份和工作空间 。 交互控制台在选择连接时使用此端点.

权限任何活动的 API 密钥

请求示例

curl -X GET "https://api.cronlume.com/v1/account" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": {
        "workspace": {
            "id": "81f9349b-8fd2-41ed-816a-4c673603b951",
            "name": "Acme Operations",
            "plan": "professional"
        },
        "api_key": {
            "id": "1cf3ef95-65c9-44d3-90e2-c473c0ff7a39",
            "name": "Production automation",
            "prefix": "crl_live_a8f94d",
            "last_used_at": "2026-08-28 20:08:31.000000"
        },
        "user": {
            "id": "f6e4f785-cbbe-45db-b179-467dcf61337d",
            "name": "Alex Morgan",
            "email": "alex@example.com"
        }
    }
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
APIDMAIN (英语).

连续任务

创建、检查、安排和控制HTTP cron操作。

获取/crons

列表和搜索 cron 任务

根据业务紧急命令返回工作岗位。 组合过滤器以快速定位工程,事件状态或终点.

权限任何 API 密钥

请求字段

查询参数
search字符串可选

搜索标题,URL和描述.

示例 invoices
status语句可选

等待,健康,退化,下降或停顿。

示例 down
active布尔可选

过滤活动或已禁用的工作 。

示例 true
group_id用户名可选

按项目/地点组进行过滤。

category_id用户名可选

按类别过滤。

limit整数可选

1–100. 默认为50.

示例 50
offset整数可选

页:1 默认为 0.

示例 0

请求示例

curl -X GET "https://api.cronlume.com/v1/crons?search=invoices&status=down&active=true&group_id=&category_id=&limit=50&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": [
        {
            "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "name": "Generate customer invoices",
            "description": "Creates invoices for completed billing periods.",
            "criticality": "critical",
            "url": "https://billing.example.com/tasks/invoices",
            "method": "POST",
            "cron_expression": "*/15 * * * *",
            "timezone": "Europe/Brussels",
            "timeout_seconds": 180,
            "failure_threshold": 3,
            "failure_action_enabled": true,
            "failure_action_threshold": 3,
            "failure_action_url": "https://backup.example.com/recover/invoices",
            "is_active": true,
            "current_status": "healthy",
            "next_run_at": "2026-08-28 20:15:00.000000",
            "last_run_at": "2026-08-28 20:00:00.000000",
            "consecutive_failures": 0,
            "group_name": "Billing platform",
            "category_ids": [
                "125976d5-c276-481c-984c-a9b4b70e477e"
            ]
        }
    ],
    "pagination": {
        "total": 1,
        "limit": 50,
        "offset": 0
    }
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
邮政/crons

创建 crun 任务

创建全监视的 HTTP 调度 。 要求的字段是故意最小化的;每个业务保障都可以在同一请求中配置.

权限写入的 API 密钥

请求字段

JSON 体质
name字符串需求

人类可读标题用于搜索,警报和事件时间表.

示例 Generate customer invoices
url網址需求

HTTP或由行刑人员调用HTTPS端点. 永远不要在 URL 中放置证书 。

示例 https://billing.example.com/tasks/invoices
cron_expression字符串需求

标准五地克龙塔布表达方式:分,分,分,月,月和周.

示例 */15 * * * *
description字符串可选

应对人员的业务目的和安全环境。 最多600个字符 。

示例 Creates invoices for completed billing periods.
criticality语句可选

标准、重要或关键。 默认为重要 。

示例 critical
method语句可选

快,快,快,快,快,快,快,快,快,快 默认得到。

示例 POST
headers对象可选

HTTP 请求头 。 存储加密。 支持请求中不包括这些请求。

示例 {"Authorization":"Bearer service-token"}
body字符串可选

Raw HTTP 请求正文发送到终点.

示例 {"source":"cronlume"}
group_idUUID |null 语句可选

在同一工作空间中的现有组。

category_ids用户编号 []可选

在同一工作空间的现有类别标识符。

示例 []
timezoneIANA 时区可选

时区用来评价克龙表达式. 默认为 UTC 。

示例 Europe/Brussels
timeout_seconds整数可选

请求的最长总期限 。 长跑终点得到支持. 默认为120

示例 180
connect_timeout_seconds整数可选

最大连接建立时间 。 默认为15.

示例 20
follow_redirects布尔可选

跟随HTTP重定向. 默认为真.

示例 1
verify_tls布尔可选

校验远程 TLS 证书 。 在生产中保持启用 。

示例 1
expected_status_min整数可选

最低的HTTP状态被认为是成功的. 默认为200.

示例 200
expected_status_max整数可选

最高HTTP状态被认为是成功的. 默认为399.

示例 399
max_retries整数可选

请求失败后的其他尝试 。 默认为 2.

示例 2
retry_backoff_seconds整数可选

重试尝试之间的延迟 。 默认为 30.

示例 30
failure_threshold整数可选

连续的处决失败, 默认为 2.

示例 3
recovery_threshold整数可选

解决事件需要连续的成功。 默认为 1 。

示例 1
alert_repeat_minutes整数可选

持续事件警报重复间隔. 默认为15.

示例 15
grace_seconds整数可选

错过运行之前的时间安排宽限期被认为是迟到的. 默认为 60.

示例 60
alert_on_pause布尔可选

当任务自动或手动被禁用时发送提醒. 默认为真.

示例 1
failure_action_enabled布尔可选

到达配置的失败记录时呼叫紧急 URL 。

示例 1
failure_action_threshold整数可选

触发紧急 URL 的失败数 。 范围1-20。

示例 3
failure_action_urlURL 无效可选

紧急 HTTP( S) URL 。 必须与主 URL 不同 。

示例 https://backup.example.com/recover/invoices
is_active布尔可选

创建活动或暂停的工作 。 默认为真.

示例 1

请求示例

curl -X POST "https://api.cronlume.com/v1/crons" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Generate customer invoices",
    "url": "https://billing.example.com/tasks/invoices",
    "cron_expression": "*/15 * * * *",
    "timezone": "Europe/Brussels",
    "method": "POST",
    "timeout_seconds": 180,
    "criticality": "critical",
    "failure_threshold": 3,
    "alert_on_pause": true,
    "failure_action_enabled": true,
    "failure_action_threshold": 3,
    "failure_action_url": "https://backup.example.com/recover/invoices"
}'

示例响应

201
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

可能的回应

201创建 Cron 工作
401无效的 API 密钥
422缺少字段、 无效的 cron 表达式或无效的紧急 URL
准备交互式测试表...
获取/crons/{cron_id}

找一份工作来

返回完整的配置和当前运行状态,包括用于授权工程用途的已解密的请求头. 将反应视为敏感.

权限任何 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

Cron工作标识符。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821

请求示例

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

可能的回应

200已返回 Cron 任务
401无效的 API 密钥
404在此工作空间中找不到 Cron 任务
准备交互式测试表...
帕齐/crons/{cron_id}

更改括号配置

更新一个或多个支持字段。 输入字段保留其当前值 。 更改时间表或时区重新计算下个 run at。

权限写入的 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

Cron工作标识符。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821
JSON 体质
name字符串可选

人类可读标题用于搜索,警报和事件时间表.

示例 Generate customer invoices
url網址可选

HTTP或由行刑人员调用HTTPS端点. 永远不要在 URL 中放置证书 。

示例 https://billing.example.com/tasks/invoices
cron_expression字符串可选

标准五地克龙塔布表达方式:分,分,分,月,月和周.

示例 */15 * * * *
description字符串可选

应对人员的业务目的和安全环境。 最多600个字符 。

示例 Creates invoices for completed billing periods.
criticality语句可选

标准、重要或关键。 默认为重要 。

示例 critical
method语句可选

快,快,快,快,快,快,快,快,快,快 默认得到。

示例 POST
headers对象可选

HTTP 请求头 。 存储加密。 支持请求中不包括这些请求。

示例 {"Authorization":"Bearer service-token"}
body字符串可选

Raw HTTP 请求正文发送到终点.

示例 {"source":"cronlume"}
group_idUUID |null 语句可选

在同一工作空间中的现有组。

category_ids用户编号 []可选

在同一工作空间的现有类别标识符。

示例 []
timezoneIANA 时区可选

时区用来评价克龙表达式. 默认为 UTC 。

示例 Europe/Brussels
timeout_seconds整数可选

请求的最长总期限 。 长跑终点得到支持. 默认为120

示例 180
connect_timeout_seconds整数可选

最大连接建立时间 。 默认为15.

示例 20
follow_redirects布尔可选

跟随HTTP重定向. 默认为真.

示例 1
verify_tls布尔可选

校验远程 TLS 证书 。 在生产中保持启用 。

示例 1
expected_status_min整数可选

最低的HTTP状态被认为是成功的. 默认为200.

示例 200
expected_status_max整数可选

最高HTTP状态被认为是成功的. 默认为399.

示例 399
max_retries整数可选

请求失败后的其他尝试 。 默认为 2.

示例 2
retry_backoff_seconds整数可选

重试尝试之间的延迟 。 默认为 30.

示例 30
failure_threshold整数可选

连续的处决失败, 默认为 2.

示例 3
recovery_threshold整数可选

解决事件需要连续的成功。 默认为 1 。

示例 1
alert_repeat_minutes整数可选

持续事件警报重复间隔. 默认为15.

示例 15
grace_seconds整数可选

错过运行之前的时间安排宽限期被认为是迟到的. 默认为 60.

示例 60
alert_on_pause布尔可选

当任务自动或手动被禁用时发送提醒. 默认为真.

示例 1
failure_action_enabled布尔可选

到达配置的失败记录时呼叫紧急 URL 。

示例 1
failure_action_threshold整数可选

触发紧急 URL 的失败数 。 范围1-20。

示例 3
failure_action_urlURL 无效可选

紧急 HTTP( S) URL 。 必须与主 URL 不同 。

示例 https://backup.example.com/recover/invoices
is_active布尔可选

创建活动或暂停的工作 。 默认为真.

示例 1

请求示例

curl -X PATCH "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "cron_expression": "0 */2 * * *",
    "timeout_seconds": 240,
    "failure_threshold": 4
}'

示例响应

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "0 */2 * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 240,
        "failure_threshold": 4,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
迪莱特/crons/{cron_id}

永久删除 crun 任务

删除此任务及其执行历史 。 这一行动是永久性的,没有回复机构。

权限写入的 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

Cron工作标识符。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821

请求示例

curl -X DELETE "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

204
No response body

可能的回应

204已删除的 Cron 任务和相关历史
401无效的 API 密钥
404未找到 Cron 任务
准备交互式测试表...
邮政/crons/{cron_id}/activate

激活或重新启动克龙

清除暂停日期和理由,重新设置锁并计算下一个执行。

权限写入的 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

Cron工作标识符。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821

请求示例

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/activate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "pending",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

可能的回应

200已更改 Cron 状态
401无效的 API 密钥
404未找到 Cron 任务
准备交互式测试表...
邮政/crons/{cron_id}/deactivate

禁用括号

停止未来的处决,并记录UTC确切的暂停时间戳和API理由.

权限写入的 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

Cron工作标识符。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821

请求示例

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/deactivate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": false,
        "current_status": "paused",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

可能的回应

200已更改 Cron 状态
401无效的 API 密钥
404未找到 Cron 任务
准备交互式测试表...
邮政/crons/{cron_id}/run

立即执行

将下一条 run at移动到当前 UTC时间. 调度员同步接受任务.

权限写入的 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

Cron工作标识符。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821

请求示例

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

202
{
    "accepted": true,
    "cron_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
}

可能的回应

202执行队列已执行
409Cron 不活动; 先激活它
401无效的 API 密钥
404未找到 Cron 任务
准备交互式测试表...
邮政/crons/bulk-activate

恢复多个 crun 任务

在服务器停用或解决了事件后重新激活选定的已禁用的工作 。 未知或已激活的标识符被忽略 。

权限写入的 API 密钥

请求字段

JSON 体质
job_ids用户编号 []需求

需要重新激活的独有克龙标识符 。 建议的最大批次:200个。

示例 ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]

请求示例

curl -X POST "https://api.cronlume.com/v1/crons/bulk-activate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ]
}'

示例响应

200
{
    "data": {
        "reactivated_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "reactivated_count": 1,
        "ignored_count": 0
    }
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
邮政/crons/{cron_id}/duplicate

安全地复制一个克龙

创建精确的操作副本,包括类别,提醒通道,加密头和请求正文. 副本总是被暂停并明确命名,这样可以在激活前被审查而不会引起双重处决.

权限写入的 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

源 crun 任务标识符 。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821

请求示例

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/duplicate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

201
{
    "data": {
        "id": "44079c1f-a0eb-45f0-b998-0c81017b2cc2",
        "name": "Generate customer invoices (copy)",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": false,
        "current_status": "paused",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ],
        "paused_at": "2026-08-29 14:22:00.000000",
        "pause_reason": "Duplicated safely through developer API \u2014 review before activation"
    }
}

可能的回应

201已暂停的重复创建
401无效的 API 密钥
404未找到源代码
准备交互式测试表...
邮政/crons/bulk-pause

暂停多个 cron 工作

在一个操作中暂停多达200个活跃的工作. CronLume记录了UTC确切的暂停时间,以及每个受影响工作的开发者-API理由. 未知、无法访问和已暂停的识别符被报告为被忽略 。

权限写入的 API 密钥

请求字段

JSON 体质
job_ids用户编号 []需求

唯一可暂停的 cron 标识符 。 最多200块

示例 ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]

请求示例

curl -X POST "https://api.cronlume.com/v1/crons/bulk-pause" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ]
}'

示例响应

200
{
    "data": {
        "paused_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "paused_count": 1,
        "ignored_count": 0
    }
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
邮政/crons/bulk-move

将多个 cron 任务移动到组

将最多200个工作转移到项目,网站,服务或客户组. 发送组 id 无效, 无法使所选任务不分组 。 只能使用来自认证的工作空间的工作和组。

权限写入的 API 密钥

请求字段

JSON 体质
job_ids用户编号 []需求

唯一可移动的克龙标识符 。 最多200块

示例 ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]
group_idUUID |null 语句需求

目标组标识符, 或对未分组无效 。

示例 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b

请求示例

curl -X POST "https://api.cronlume.com/v1/crons/bulk-move" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ],
    "group_id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b"
}'

示例响应

200
{
    "data": {
        "moved_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "moved_count": 1,
        "ignored_count": 0,
        "group_id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b"
    }
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
APIDMAIN (英语).

处决

调查时机,HTTP结果,重复和紧急行动.

获取/crons/{cron_id}/executions

列表执行历史

检查反应时间, HTTP状态, 重复和安全反应证据为单克龙. 最近的处决是先退回的。

权限任何 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

Cron工作标识符。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821
查询参数
limit整数可选

1–200. 默认为50.

示例 50

请求示例

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/executions?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": [
        {
            "id": 18492,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "scheduled_at": "2026-08-28 20:00:00.000000",
            "started_at": "2026-08-28 20:00:00.143000",
            "finished_at": "2026-08-28 20:00:01.381000",
            "duration_ms": 1238,
            "status": "succeeded",
            "attempt": 1,
            "http_status": 200,
            "error_type": null,
            "error_message": null,
            "response_excerpt": "{\"processed\":42}",
            "worker_id": "scheduler-eu-01"
        }
    ]
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
获取/crons/{cron_id}/failure-actions

列出紧急行动处决

检查每一次被连续失败规则所触发的恢复 URL 引用 。

权限任何 API 密钥

请求字段

路径参数
cron_idUUID 路径需求

Cron工作标识符。

示例 a870d9ac-3a0f-49bb-b8e2-5f392fffc821
查询参数
limit整数可选

1–200. 默认为50.

示例 50

请求示例

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/failure-actions?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": [
        {
            "id": 218,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "trigger_failure_count": 3,
            "url": "https://backup.example.com/recover/invoices",
            "duration_ms": 842,
            "status": "succeeded",
            "http_status": 204,
            "worker_id": "scheduler-eu-01"
        }
    ]
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
APIDMAIN (英语).

组织

按项目、网站、服务、客户和业务类别划分的结构车队。

获取/groups

列表组

返回每个工程、网站、服务或其他配置在认证的工作空间。

权限任何 API 密钥

请求示例

curl -X GET "https://api.cronlume.com/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": [
        {
            "id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b",
            "group_type": "service",
            "name": "Billing platform",
            "client_reference": "CLIENT-ACME-0042",
            "description": "Customer billing automation",
            "color": "#147d64"
        }
    ]
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
邮政/groups

创建组

创建可重复使用的项目、网站、服务或其他用于组织克龙船队的服务。

权限写入的 API 密钥

请求字段

JSON 体质
name字符串需求

工作空间内唯一组名 。

示例 Billing platform
group_type语句可选

项目、网站、服务或其他。

示例 service
client_reference字符串点数可选

客户、合同或内部参考。 最多160个字符。

示例 CLIENT-ACME-0042
description字符串点数可选

目的和所有权背景。

示例 Customer billing automation
color六进制颜色可选

盘子显示颜色 。

示例 #147d64

请求示例

curl -X POST "https://api.cronlume.com/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "group_type": "service",
    "name": "Billing platform",
    "client_reference": "CLIENT-ACME-0042",
    "description": "Customer billing automation",
    "color": "#147d64"
}'

示例响应

201
{
    "data": {
        "id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b",
        "group_type": "service",
        "name": "Billing platform",
        "client_reference": "CLIENT-ACME-0042",
        "description": "Customer billing automation",
        "color": "#147d64"
    }
}

可能的回应

201创建组
401无效的 API 密钥
422无效或重复的值
准备交互式测试表...
帕齐/groups/{group_id}

更新组

更改一个或多个字段 。 汇出地保持不变。

权限写入的 API 密钥

请求字段

路径参数
group_idUUID 路径需求

组标识符 。

示例 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b
JSON 体质
name字符串可选

工作空间内唯一组名 。

示例 Billing platform
group_type语句可选

项目、网站、服务或其他。

示例 service
client_reference字符串点数可选

客户、合同或内部参考。 最多160个字符。

示例 CLIENT-ACME-0042
description字符串点数可选

目的和所有权背景。

示例 Customer billing automation
color六进制颜色可选

盘子显示颜色 。

示例 #147d64

请求示例

curl -X PATCH "https://api.cronlume.com/v1/groups/6ef63789-baf1-44fc-99bb-0c5ce2d37a8b" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing platform Production"
}'

示例响应

200
{
    "updated": true
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
迪莱特/groups/{group_id}

删除组

删除组织项目。 工作仍然可用;被删除的组关系变为空.

权限写入的 API 密钥

请求字段

路径参数
group_idUUID 路径需求

组标识符 。

示例 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b

请求示例

curl -X DELETE "https://api.cronlume.com/v1/groups/6ef63789-baf1-44fc-99bb-0c5ce2d37a8b" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

204
No response body

可能的回应

204组项目已删除
401无效的 API 密钥
404未找到的项目
准备交互式测试表...
获取/categories

列表类别

返回在认证的工作空间中配置的每个操作类别 。

权限任何 API 密钥

请求示例

curl -X GET "https://api.cronlume.com/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": [
        {
            "id": "125976d5-c276-481c-984c-a9b4b70e477e",
            "name": "Billing",
            "description": "Invoice and payment workflows",
            "color": "#46769b"
        }
    ]
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
邮政/categories

创建分类

创建可重复使用的操作类别来组织克龙舰队.

权限写入的 API 密钥

请求字段

JSON 体质
name字符串需求

工作空间内唯一分类名称 。

示例 Billing
description字符串点数可选

业务类别说明。

示例 Invoice and payment workflows
color六进制颜色可选

盘子显示颜色 。

示例 #46769b

请求示例

curl -X POST "https://api.cronlume.com/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing",
    "description": "Invoice and payment workflows",
    "color": "#46769b"
}'

示例响应

201
{
    "data": {
        "id": "125976d5-c276-481c-984c-a9b4b70e477e",
        "name": "Billing",
        "description": "Invoice and payment workflows",
        "color": "#46769b"
    }
}

可能的回应

201创建类别
401无效的 API 密钥
422无效或重复的值
准备交互式测试表...
帕齐/categories/{category_id}

更新分类

更改一个或多个字段 。 汇出地保持不变。

权限写入的 API 密钥

请求字段

路径参数
category_idUUID 路径需求

类别标识符。

示例 125976d5-c276-481c-984c-a9b4b70e477e
JSON 体质
name字符串可选

工作空间内唯一分类名称 。

示例 Billing
description字符串点数可选

业务类别说明。

示例 Invoice and payment workflows
color六进制颜色可选

盘子显示颜色 。

示例 #46769b

请求示例

curl -X PATCH "https://api.cronlume.com/v1/categories/125976d5-c276-481c-984c-a9b4b70e477e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing Production"
}'

示例响应

200
{
    "updated": true
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
迪莱特/categories/{category_id}

删除分类

删除组织项目。 工作仍然可用;被删除的组关系变为空.

权限写入的 API 密钥

请求字段

路径参数
category_idUUID 路径需求

类别标识符。

示例 125976d5-c276-481c-984c-a9b4b70e477e

请求示例

curl -X DELETE "https://api.cronlume.com/v1/categories/125976d5-c276-481c-984c-a9b4b70e477e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

204
No response body

可能的回应

204删除的类别
401无效的 API 密钥
404未找到的项目
准备交互式测试表...
APIDMAIN (英语).

事件

阅读和承认需要专业关注的失败。

获取/incidents

清单事件

按开放时间命令返回多达500起事件。 答复载有公开、承认和解决的业务历史。

权限任何 API 密钥

请求示例

curl -X GET "https://api.cronlume.com/v1/incidents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "data": [
        {
            "id": 731,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "cron_name": "Generate customer invoices",
            "status": "open",
            "severity": "critical",
            "summary": "Generate customer invoices failed 3 times",
            "details": "Remote endpoint returned HTTP 503.",
            "failure_count": 3,
            "opened_at": "2026-08-28 20:00:02.000000",
            "acknowledged_at": null,
            "resolved_at": null
        }
    ]
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...
邮政/incidents/{incident_id}/acknowledge

确认出事

将公开事件标为确认,并记录世界协调时确认的确切时间。

权限写入的 API 密钥

请求字段

路径参数
incident_id整数路径需求

事件识别器。

示例 731

请求示例

curl -X POST "https://api.cronlume.com/v1/incidents/731/acknowledge" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

示例响应

200
{
    "acknowledged": true
}

可能的回应

200请求成功完成
401缺少、 无效或过期的 API 密钥
403授权不足
422请求验证失败
准备交互式测试表...