API 参考回调端点
更新端点
PATCH /endpoints/{id}
更新端点
调用 `PATCH /endpoints/{id}`，更新端点。
https://api.edgecron.com/v1/endpoints/{id}
需要认证
每个请求都需要携带 `X-Key-ID`、`X-Timestamp` 和 `X-Signature`。签名为 `timestamp + "\n" + payload` 的 HMAC-SHA256 小写十六进制结果。
参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
id | path | integer | 是 | 资源 ID。 |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 否 | - |
url | string | 否 | - |
method | GET / POST / PUT / PATCH / DELETE | 否 | 可选值：GET, POST, PUT, PATCH, DELETE。 |
headers | string | 否 | - |
secret | string | 否 | - |
clear_secret | boolean | 否 | Set true to remove the endpoint signing secret. Future deliveries will not include X-EdgeCron-Signature. |
timeout_ms | integer (int32) | 否 | - |
retry_policy_id | integer (int64) | 否 | - |
filter_events | string | 否 | - |
{
"name": "billing-webhook",
"url": "https://example.com/webhooks/edgecron",
"method": "GET",
"headers": {
"X-Service": "billing"
},
"secret": "whsec_example",
"clear_secret": true,
"timeout_ms": 5000,
"retry_policy_id": 101,
"filter_events": "invoice.*"
}响应
所有成功响应都使用 EdgeCron API 统一信封。
{
"code": 0,
"message": "success",
"request_id": "req_abc123",
"data": {
"id": 101,
"app_id": "app_123",
"name": "billing-webhook",
"url": "https://example.com/webhooks/edgecron",
"method": "POST",
"headers": {},
"secret": "whsec_example",
"timeout_ms": 5000,
"retry_policy_id": 101,
"filter_events": "invoice.*",
"status": "enabled",
"created_at": "2026-07-01T12:00:00Z",
"updated_at": "2026-07-01T12:00:00Z"
}
}结构
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer | 否 | 资源 ID。 |
app_id | string | 否 | 应用 ID。 |
name | string | 否 | - |
url | string (uri) | 否 | - |
method | POST / PUT / PATCH | 否 | 可选值：POST, PUT, PATCH。 |
headers | object | 否 | - |
secret | string | 否 | - |
timeout_ms | integer | 否 | - |
retry_policy_id | integer | 否 | - |
filter_events | string | 否 | - |
status | enabled / disabled | 否 | 可选值：enabled, disabled。 |
created_at | string (date-time) | 否 | 创建时间。 |
updated_at | string (date-time) | 否 | 最后更新时间。 |