变更列表 - Flashcat API

请求参数

Authorization

在 query 添加参数

app_key

示例：

app_key: ********************

Body 参数application/json

p

integer

页码，从1开始

可选

limit

integer

分页条数

可选

asc

boolean

是否升序

可选

start_time

integer

开始时间戳

必需

end_time

integer

结束时间

必需

filters

array[array (AndFilters) {1}]

过滤条件

可选

外层条件，条件之间为OR关系

object (Filter)

内层条件

可选

include_events

boolean

是否同时返回事件

可选

示例

{
  "p": 0,
  "limit": 0,
  "asc": true,
  "start_time": 0,
  "end_time": 0,
  "filters": [
    [
      {
        "key": "title",
        "oper": "IN",
        "vals": [
          "string"
        ]
      }
    ]
  ],
  "include_events": true
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.flashcat.cloud/change/list?app_key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "p": 0,
    "limit": 0,
    "asc": true,
    "start_time": 0,
    "end_time": 0,
    "filters": [
        [
            {
                "key": "title",
                "oper": "IN",
                "vals": [
                    "string"
                ]
            }
        ]
    ],
    "include_events": true
}'

返回响应

🟢200成功

application/json

Body

error

object (DutyError)

可选

code

enum<string>

错误码

必需

枚举值:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

错误描述

必需

data

object

可选

items

array[object (Change) {12}]

变更条目

必需

has_next_page

boolean

是否有下一页

必需

total

integer

总条目数

必需

示例

{
  "error": {
    "code": "InvalidParameter",
    "message": "string"
  },
  "data": {
    "items": [
      {
        "change_id": "string",
        "data_source_id": 0,
        "data_source_name": "string",
        "title": "string",
        "description": "string",
        "change_key": "string",
        "change_status": "Planned",
        "start_time": 0,
        "last_time": 0,
        "end_time": 0,
        "labels": {},
        "events": [
          {
            "event_id": "string",
            "data_source_id": 0,
            "title": "string",
            "description": "string",
            "change_key": "string",
            "change_status": "Planned",
            "link": "string",
            "event_time": 0,
            "labels": {}
          }
        ]
      }
    ],
    "has_next_page": true,
    "total": 0
  }
}