跳转到主要内容
API Explorer|API Explorer
告警与响应相关接口/值班
POSTOnCall起始版本 1.0同步需要认证

解决值班冲突

分析冲突返回已排序分辨率建议。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

请求体字段

  • conflictsList必填

    冲突列表。

    示例： (nested array)

    • typeString

      类型。

      示例： overlap

    • userIdString

      用户ID。

      示例： user-abc123

    • userNameString

      用户名称。

      示例： Alice Smith

    • detailsString

      详细信息。

      示例： Overlapping shifts on 2024-06-01

  • allSchedulesList必填

    全部排班列表。

    示例： (nested array)

    • uuidString

      资源的UUID，唯一标识该资源。

      示例： sched-00112233

    • nameString

      资源名称。

      示例： Platform On-Call

    • descriptionString

      资源的详细描述。

      示例： 24x7 platform on-call rotation

    • timezoneString

      时区。

      示例： Asia/Shanghai

    • rotationTypeString

      轮换类型。

      示例： weekly

    • shiftDurationString

      班次时长。

      示例： 168h

    • membersList

      成员列表。

      示例： (nested array)

      • userIdString

        用户ID。

        示例： user-abc123

      • userNameString

        用户名称。

        示例： Alice Smith

      • orderInteger

        顺序号。

        示例： 1

    • startDateString

      生效开始日期。

      示例： 2026-01-15T08:00:00Z

    • createDateString

      创建时间。

      示例： 2026-01-15T08:00:00Z

    • lastOpDateString

      最近一次操作时间。

      示例： 2026-01-15T08:00:00Z

  • strategyString必填

    处理策略。

    示例： auto

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • totalConflictsInteger

    总数量冲突发现分析。

    示例： 3

  • suggestionsList

    建议。

    示例： (nested array)

    • idString

      资源ID。

      示例： sugg-11223344

    • typeString

      类型。

      示例： member_swap

    • descriptionString

      资源的详细描述。

      示例： Swap shifts between Alice and Bob to resolve overlap

    • targetConflictsList

      目标冲突列表。

      示例： item1,item2

    • changesList

      变更。

      示例： (nested array)

      • scheduleUuidString

        排班UUID。

        示例： sched-00112233

      • scheduleNameString

        名称排班变更。

        示例： Platform On-Call

      • changeTypeString

        变更类型。

        示例： member_swap

      • detailsLinkedHashMap

        详细信息。

        示例： (nested object)

      • beforeString

        前文上下文日志列表。

        示例： user-abc123

      • afterString

        后续上下文日志列表。

        示例： user-xyz789

    • impactObject

      影响类型。

      • fairnessScoreLong

        公平性评分。

        示例： 0.85

      • coverageScoreLong

        覆盖评分。

        示例： 0.92

      • minimalChangeScoreLong

        最小变更评分。

        示例： 0.78

      • overallScoreLong

        综合评分。

        示例： 0.85

    • priorityInteger

      优先级。

      示例： 1

  • strategyString

    处理策略。

    示例： auto

  • generatedAtString

    生成时间。

    示例： 2026-01-15T08:00:00Z

请求地址

POST/api/v1/oncall/conflicts/resolve

/api/v1/oncall/conflicts/resolve

操作 ID

ResolveOnCallConflicts

永久链接

请求示例

curl -X POST '{host}/api/v1/oncall/conflicts/resolve' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"conflicts":"(nested array)","allSchedules":"(nested array)","strategy":"auto"}'

响应示例

200
{
  "totalConflicts": 3,
  "suggestions": [
    {}
  ],
  "strategy": "auto",
  "generatedAt": "example"
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史