Flashcat API

变更列表

POST

https://api.flashcat.cloud/change/list

最后修改时间：2023-09-14 08:15:06

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

{
    "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
    }
}

请求参数

Authorization

在 query 添加参数

app_key

示例：

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

Body 参数application/json

integer

页码，从1开始

可选

>= 1

limit

integer

每页内数据条数

可选

<= 20

asc

boolean

可选

是否升序，具体排序方式以接口为准

start_time

integer

开始时间戳

必需

end_time

integer

结束时间

必需

filters

array[array (AndFilters) {1}]

过滤条件

可选

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

object (Filter)

内层条件

可选

include_events

boolean

是否同时返回事件

可选

示例

返回响应

🟢200成功

application/json

Body

error

object (DutyError)

可选

code

enum<string>

错误码

必需

枚举值:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

错误描述

必需

data

object

可选

items

array[object (Change) {12}]

变更条目

必需

has_next_page