跳转到主要内容
ZStack
告警与响应相关接口/值班

解决值班冲突

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

POST/api/v1/oncall/conflicts/resolve

操作 ID

ResolveOnCallConflicts

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

请求体字段

  • conflicts
    List必填

    冲突列表。

    示例： (nested array)

    • type
      String

      类型。

      示例： overlap

    • userId
      String

      用户ID。

      示例： user-abc123

    • userName
      String

      用户名称。

      示例： Alice Smith

    • details
      String

      详细信息。

      示例： Overlapping shifts on 2024-06-01

  • allSchedules
    List必填

    全部排班列表。

    示例： (nested array)

    • uuid
      String

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

      示例： sched-00112233

    • name
      String

      资源名称。

      示例： Platform On-Call

    • description
      String

      资源的详细描述。

      示例： 24x7 platform on-call rotation

    • timezone
      String

      时区。

      示例： Asia/Shanghai

    • rotationType
      String

      轮换类型。

      示例： weekly

    • shiftDuration
      String

      班次时长。

      示例： 168h

    • members
      List

      成员列表。

      示例： (nested array)

      • userId
        String

        用户ID。

        示例： user-abc123

      • userName
        String

        用户名称。

        示例： Alice Smith

      • order
        Integer

        顺序号。

        示例： 1

    • startDate
      String

      生效开始日期。

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

    • createDate
      String

      创建时间。

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

    • lastOpDate
      String

      最近一次操作时间。

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

  • strategy
    String必填

    处理策略。

    示例： auto

响应状态

200 OK
200 OK

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

  • totalConflicts
    Integer

    总数量冲突发现分析。

    示例： 3

  • suggestions
    List

    建议。

    示例： (nested array)

    • id
      String

      资源ID。

      示例： sugg-11223344

    • type
      String

      类型。

      示例： member_swap

    • description
      String

      资源的详细描述。

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

    • targetConflicts
      List

      目标冲突列表。

      示例： item1,item2

    • changes
      List

      变更。

      示例： (nested array)

      • scheduleUuid
        String

        排班UUID。

        示例： sched-00112233

      • scheduleName
        String

        名称排班变更。

        示例： Platform On-Call

      • changeType
        String

        变更类型。

        示例： member_swap

      • details
        LinkedHashMap

        详细信息。

        示例： (nested object)

      • before
        String

        前文上下文日志列表。

        示例： user-abc123

      • after
        String

        后续上下文日志列表。

        示例： user-xyz789

    • impact
      Object

      影响类型。

      • fairnessScore
        Long

        公平性评分。

        示例： 0.85

      • coverageScore
        Long

        覆盖评分。

        示例： 0.92

      • minimalChangeScore
        Long

        最小变更评分。

        示例： 0.78

      • overallScore
        Long

        综合评分。

        示例： 0.85

    • priority
      Integer

      优先级。

      示例： 1

  • strategy
    String

    处理策略。

    示例： auto

  • generatedAt
    String

    生成时间。

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