# 销售机会阶段变更记录

>  获取销售机会阶段的变更历史记录

```
POST https://qw-openapi-tx.dustess.com/saleChance/v1/stageChangeHistoryList?accessToken=

Content-Type: application/json
```

**接口限制**：每分钟调用600次；

**Params:**

| 字段        | 类型     | 描述        | 是否必须 |
| ----------- | -------- | ----------- | -------- |
| saleChanceID | `String` | 销售机会ID | false     |
| newStageID | `String` | 变更后销售机会阶段ID | false     |
| startTime  | `String(Int64为保留精度转换为String)` | 变更开始时间，unix时间戳，默认为7天前的时间 | false     |
| endTime    | `String(Int64为保留精度转换为String)` | 变更结束时间，unix时间戳，默认为当前时间 | false     |
| page       | `String` | 查询页数，从1开始，默认1 | false     |
| pageSize   | `String` | 单页查询大小，默认20，最大100 | false     |

时间默认查询一周，最多可查询最近一个月（31天）数据。若传入的startTime-endTime区间超过一个月（31天），系统会静默处理startTime=endTime-31day。

**成功响应**

| 响应参数名                            | 类型       | 说明                                            |
| ------------------------------------- | ---------- | ----------------------------------------------- |
| code                                  | `Int`      | 响应码，0为成功                     |
| msg                                   | `String`   | 消息提示                                        |
| data                                  | `Object`   | 数据信息                                        |
| data.page                                  | `Int`   | 当前页                                        |
| data.pageSize                                  | `Int`   | 当前请求页大小                                        |
| data.totalPage                                  | `Int`   | 按当前请求页大小分页，页面总数                                        |
| data.total                                  | `String(Int64为保留精度转换为String)`   | 数据总数          |
| data.list                           | `Object[]` | 变更记录-按变更时间倒序                              |
| data.list.saleChanceID                        | `String`   | 销售机会ID                                      |
| data.list.time                      | `String(Int64为保留精度转换为String)`   | 变更时间，unix时间戳                                 |
| data.list.oldStageID                      | `String`   | 修改前阶段ID                                        |
| data.custom.newStageID                   | `String`     | 修改后阶段ID                                        |
| data.custom.operatorUID                   | `String` | 操作人uid，sys为系统操作 


**请求curl示例**
查询某个销售机会 `2025-04-04 10:00:00` 至 `2025-04-11 10:00:00` 的销售机会阶段变更
```shell
curl --location 'https://qw-openapi-qa.dustess.net/saleChance/v1/stageChangeHistoryList?accessToken=MZF6bf70PPt_o3wWG1xuDlVUEzADHGpVKI8gql96Tq1NhWVggIECKEEBiuxPA4iOOgPaCHTSgHdFZp9pi0P0RHj8GK4RHqEEPU_mGH_ivkU%3D' \
--header 'Content-Type: application/json' \
--data '{
    "saleChanceID":"17c577db-151a-11f0-807a-1a614ae64210",
    "startTime":"1743732000",
    "endTime":"1744336800"
}'
```

**成功响应示例**

```json
{
    "code": 0,
    "data": {
        "list": [
            {
                "newStageID": "d596ac35-1519-11f0-be04-babd6e4b9d5f",
                "oldStageID": "c7b95c57-1519-11f0-be04-babd6e4b9d5f",
                "operatorUID": "17",
                "saleChanceID": "17c577db-151a-11f0-807a-1a614ae64210",
                "time": "1744186254"
            },
            {
                "newStageID": "c7b95c57-1519-11f0-be04-babd6e4b9d5f",
                "oldStageID": "d596ac35-1519-11f0-be04-babd6e4b9d5f",
                "operatorUID": "17",
                "saleChanceID": "17c577db-151a-11f0-807a-1a614ae64210",
                "time": "1744186260"
            },
            {
                "newStageID": "d596ac35-1519-11f0-be04-babd6e4b9d5f",
                "oldStageID": "c7b95c57-1519-11f0-be04-babd6e4b9d5f",
                "operatorUID": "17",
                "saleChanceID": "17c577db-151a-11f0-807a-1a614ae64210",
                "time": "1744186273"
            },
            {
                "newStageID": "dad041a0-1519-11f0-be04-babd6e4b9d5f",
                "oldStageID": "d596ac35-1519-11f0-be04-babd6e4b9d5f",
                "operatorUID": "17",
                "saleChanceID": "17c577db-151a-11f0-807a-1a614ae64210",
                "time": "1744186283"
            },
            {
                "newStageID": "c7b95c5f-1519-11f0-be04-babd6e4b9d5f",
                "oldStageID": "dad041a0-1519-11f0-be04-babd6e4b9d5f",
                "operatorUID": "17",
                "saleChanceID": "17c577db-151a-11f0-807a-1a614ae64210",
                "time": "1744186293"
            }
        ],
        "page": 1,
        "pageSize": 20,
        "total": "5",
        "totalPage": 1
    },
    "msg": "OK",
    "success": true,
    "traceId": "6d8c7237-c4a6-991a-b6e0-b38a9b945c05"
}
```

**错误响应示例**

```json
 {
    "success": false,
    "code": -1,
    "msg": "系统异常",
    "data": {},
    "traceId": "b8b31932-13d5-9637-95a7-7f0a9a174ae9"
}
```