销售机会阶段变更记录 - 尘锋SCRM开放平台

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

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 的销售机会阶段变更

成功响应示例

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

错误响应示例

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