创建工单

POST

/api/incident/create

参考 gateway 的工单创建逻辑，在开放 API 下 create_by 写入当前 client_key。

请求参数

Authorization

API Key

在 header 添加参数

X-Client-Key

示例：

X-Client-Key: ********************

API Key

在 header 添加参数

X-Timestamp

示例：

X-Timestamp: ********************

API Key

在 header 添加参数

X-Sign

示例：

X-Sign: ********************

Body 参数application/json必填

示例

{
    "title": "Database CPU High",
    "detail": "CPU usage remains above 90% for 10 minutes",
    "severity": "S0",
    "service_id": "svc_1",
    "assign": {
        "type": "1",
        "value": ""
    },
    "labels": [
        {
            "label_id": "label_env",
            "label_value": "prod"
        }
    ],
    "attachments": [
        {
            "url": "https://example.com/screenshot.png",
            "name": "screenshot"
        }
    ],
    "source": "openapi"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/incident/create' \
--header 'X-Client-Key: <api-key>' \
--header 'X-Timestamp: <api-key>' \
--header 'X-Sign: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "Database CPU High",
    "detail": "CPU usage remains above 90% for 10 minutes",
    "severity": "S0",
    "service_id": "svc_1",
    "assign": {
        "type": "1",
        "value": ""
    },
    "labels": [
        {
            "label_id": "label_env",
            "label_value": "prod"
        }
    ],
    "attachments": [
        {
            "url": "https://example.com/screenshot.png",
            "name": "screenshot"
        }
    ],
    "source": "openapi"
}'

返回响应

🟢200

application/json

创建成功

Body

示例

{
    "code": 0,
    "msg": "OK",
    "data": {
        "incident_id": "string"
    }
}

🟠401UnauthorizedResponse

修改于 2026-04-18 03:22:09

解决工单

查询业务服务