获取商机列表 - 探马OpenAPI

信息

时间区间只支持30天内

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

salesIds

array[number]

销售id

可选

departmentIds

array[number]

部门id

可选

oppTypeId

number

商机类型id

可选

customerAllocateSource

array[integer]

获取途径

可选

1公海领取 2公司分配 3个人创建 4转移接收 5好友创建

customerSource

array[integer]

客户来源

可选

通过客户自定义字段接口查询

channelState

array[string]

渠道来源

可选

通过web页面查看

createRange

object

创建时间

可选

startTime

string

开始时间

必需

endTime

string

结束时间

必需

turnoverRange

object

预计成交时间

可选

startTime

string

必需

endTime

string

必需

dealRange

object

赢单时间

可选

startTime

string

开始时间

必需

2023-01-27 00:00:00

endTime

string

结束时间

必需

2023-01-27 00:00:00

updateRange

object

更新时间

可选

startTime

string

开始时间

必需

2023-01-27 00:00:00

endTime

string

结束时间

必需

2023-01-27 00:00:00

pageSize

integer

页码

可选

默认50

pageNo

integer

页数

可选

默认1

示例

{
  "salesIds": [
    447253093488704
  ],
  "departmentIds": [
    447253093488704
  ],
  "customerAllocateSource": [
    1
  ],
  "customerSource": [
    1
  ],
  "channelState": [
    "渠道来源"
  ],
  "createRange": {
    "startTime": "2002-10-05 02:01:05",
    "endTime": "2009-11-26 03:23:02"
  },
  "turnoverRange": {
    "startTime": "1999-03-04 12:17:44",
    "endTime ": "2013-05-14 23:06:31"
  },
  "dealRange": {
    "startTime": "2015-11-19 18:11:47",
    "endTime": "2008-03-09 19:45:53"
  },
  "pageSize": 50,
  "pageNo": 1,
  "updateRange": {
    "startTime": "1977-05-23 23:21:25",
    "endTime": "2012-10-06 21:02:29"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

totalCount

integer

总数量

必需

totalPage

integer

总页数

必需

pageNo

integer

当前页

必需

pageSize

integer

每页数量

必需

result

array [object {23}]

数据

必需

示例

{
  "code": 0,
  "message": "success",
  "data": {
    "totalCount": 6,
    "totalPage": 1,
    "pageNo": 0,
    "pageSize": 50,
    "result": [
      {
        "id": 468322372786240,
        "corpid": "ww9c5530210a0d5116",
        "name": "空调10",
        "customerId": 468320448223296,
        "mainSalesId": 459662865780800,
        "salesName": "任祥德",
        "opportunityId": 413255622797376,
        "stageId": 447253093488704,
        "stageAt": "2022-03-31 16:17:13",
        "stageName": "阶段一",
        "expectedDealTime": "2022-04-01 00:00:00",
        "expectedDealAmount": 1,
        "possibility": 2,
        "gmtCreateTime": "2022-03-31 16:17:13",
        "fieldValues": [
          {
            "id": 463149358395456,
            "name": "测试",
            "value": "1"
          },
          {
            "id": 464217610952640,
            "name": "ppp",
            "value": "[464217610960832]"
          }
        ],
        "endReason": null,
        "endReasonName": null,
        "opportunityCommodityList": null,
        "createSalesId": 389394161352768,
        "createSalesName": "admin",
        "gmtUpdateTime": "2022-03-31 16:17:13",
        "lastUpdateSalesId": 389394161352768,
        "lastUpdateSalesName": "admin",
        "gmtDeleteTime": null,
        "deleteSalesId": null,
        "deleteSalesName": null,
        "salesDeptNames": "[\"探马企服/西瓜的部门\"]"
      },
      {
        "id": 468322624315456,
        "corpid": "ww9c5530210a0d5116",
        "name": "空调10",
        "customerId": 468320448223296,
        "mainSalesId": 459662865780800,
        "salesName": "任祥德",
        "opportunityId": 413255622797376,
        "stageId": 450945882214466,
        "stageAt": "2022-03-31 16:26:04",
        "stageName": "阶段四",
        "expectedDealTime": "2022-03-31 00:00:00",
        "expectedDealAmount": 1,
        "possibility": 10,
        "gmtCreateTime": "2022-03-31 16:19:16",
        "fieldValues": [
          {
            "id": 463149358395456,
            "name": "测试",
            "value": "1"
          },
          {
            "id": 464217610952640,
            "name": "ppp",
            "value": "[464217610960832]"
          }
        ],
        "endReason": null,
        "endReasonName": null,
        "opportunityCommodityList": null,
        "createSalesId": 389394161352768,
        "createSalesName": "admin",
        "gmtUpdateTime": "2022-03-31 16:26:04",
        "lastUpdateSalesId": 389394161352768,
        "lastUpdateSalesName": "admin",
        "gmtDeleteTime": null,
        "deleteSalesId": null,
        "deleteSalesName": null,
        "salesDeptNames": "[\"探马企服/西瓜的部门\"]"
      },
      {
        "id": 468346831359936,
        "corpid": "ww9c5530210a0d5116",
        "name": "风扇9",
        "customerId": 468320448223296,
        "mainSalesId": 459662865780800,
        "salesName": "任祥德",
        "opportunityId": 413255622797376,
        "stageId": 413261763471425,
        "stageAt": "2022-04-01 14:25:47",
        "stageName": "测试名字长度测试名字长度测试名字长度测试",
        "expectedDealTime": "2022-04-01 00:00:00",
        "expectedDealAmount": 123,
        "possibility": 100,
        "gmtCreateTime": "2022-03-31 19:36:16",
        "fieldValues": [
          {
            "id": 463149358395456,
            "name": "测试",
            "value": "1"
          },
          {
            "id": 464217610952640,
            "name": "ppp",
            "value": "[]"
          }
        ],
        "endReason": null,
        "endReasonName": null,
        "opportunityCommodityList": null,
        "createSalesId": 389394161352768,
        "createSalesName": "admin",
        "gmtUpdateTime": "2022-04-01 14:25:47",
        "lastUpdateSalesId": 389394161352768,
        "lastUpdateSalesName": "admin",
        "gmtDeleteTime": null,
        "deleteSalesId": null,
        "deleteSalesName": null,
        "salesDeptNames": "[\"探马企服/西瓜的部门\"]"
      },
      {
        "id": 468485663504448,
        "corpid": "ww9c5530210a0d5116",
        "name": "风扇9",
        "customerId": 468320448223296,
        "mainSalesId": 459662865780800,
        "salesName": "任祥德",
        "opportunityId": 413255622797376,
        "stageId": 447253093488704,
        "stageAt": "2022-04-01 14:26:05",
        "stageName": "阶段一",
        "expectedDealTime": "2022-04-02 00:00:00",
        "expectedDealAmount": 123,
        "possibility": 2,
        "gmtCreateTime": "2022-04-01 14:26:05",
        "fieldValues": [
          {
            "id": 463149358395456,
            "name": "测试",
            "value": "1"
          },
          {
            "id": 464217610952640,
            "name": "ppp",
            "value": "[]"
          }
        ],
        "endReason": null,
        "endReasonName": null,
        "opportunityCommodityList": null,
        "createSalesId": 389394161352768,
        "createSalesName": "admin",
        "gmtUpdateTime": "2022-04-01 14:26:05",
        "lastUpdateSalesId": 389394161352768,
        "lastUpdateSalesName": "admin",
        "gmtDeleteTime": null,
        "deleteSalesId": null,
        "deleteSalesName": null,
        "salesDeptNames": "[\"探马企服/西瓜的部门\"]"
      },
      {
        "id": 522609428754368,
        "corpid": "ww9c5530210a0d5116",
        "name": "1111111111111111111111111111111123而是哈哈哈哈哈哈哈哈哈哈哈",
        "customerId": 522453003825088,
        "mainSalesId": 459662865780800,
        "salesName": "任祥德",
        "opportunityId": 413255622797376,
        "stageId": 450945882214471,
        "stageAt": "2023-02-01 11:26:25",
        "stageName": "阶段八",
        "expectedDealTime": "2023-02-23 00:00:00",
        "expectedDealAmount": 99,
        "possibility": 90,
        "gmtCreateTime": "2023-02-01 11:26:25",
        "fieldValues": [
          {
            "id": 476426262028352,
            "name": "2222",
            "value": ""
          },
          {
            "id": 471863808317376,
            "name": "123",
            "value": ""
          },
          {
            "id": 471679616186305,
            "name": "测试1",
            "value": "s"
          },
          {
            "id": 463149358395456,
            "name": "测试",
            "value": "s"
          },
          {
            "id": 475938774364224,
            "name": "1111",
            "value": ""
          },
          {
            "id": 464217610952640,
            "name": "ppp",
            "value": "[]"
          },
          {
            "id": 476425671333824,
            "name": "11111",
            "value": ""
          }
        ],
        "endReason": null,
        "endReasonName": null,
        "opportunityCommodityList": null,
        "createSalesId": 389394161352768,
        "createSalesName": "admin",
        "gmtUpdateTime": "2023-02-01 11:26:25",
        "lastUpdateSalesId": 389394161352768,
        "lastUpdateSalesName": "admin",
        "gmtDeleteTime": null,
        "deleteSalesId": null,
        "deleteSalesName": null,
        "salesDeptNames": "[\"探马企服/西瓜的部门\"]"
      },
      {
        "id": 522778582044736,
        "corpid": "ww9c5530210a0d5116",
        "name": "洗衣机7",
        "customerId": 522453003825088,
        "mainSalesId": 459662865780800,
        "salesName": "任祥德",
        "opportunityId": 413255622797376,
        "stageId": 447253093488704,
        "stageAt": "2023-02-02 10:22:59",
        "stageName": "阶段一",
        "expectedDealTime": "2023-02-03 00:00:00",
        "expectedDealAmount": 11,
        "possibility": 2,
        "gmtCreateTime": "2023-02-02 10:22:59",
        "fieldValues": [
          {
            "id": 476426262028352,
            "name": "2222",
            "value": ""
          },
          {
            "id": 471863808317376,
            "name": "123",
            "value": "22"
          },
          {
            "id": 471679616186305,
            "name": "测试1",
            "value": "吃啥"
          },
          {
            "id": 463149358395456,
            "name": "测试",
            "value": "测"
          },
          {
            "id": 475938774364224,
            "name": "1111",
            "value": "22"
          },
          {
            "id": 464217610952640,
            "name": "ppp",
            "value": "[]"
          },
          {
            "id": 476425671333824,
            "name": "11111",
            "value": "2023-02-02"
          }
        ],
        "endReason": null,
        "endReasonName": null,
        "opportunityCommodityList": null,
        "createSalesId": 389394161352768,
        "createSalesName": "admin",
        "gmtUpdateTime": "2023-02-02 10:22:59",
        "lastUpdateSalesId": 389394161352768,
        "lastUpdateSalesName": "admin",
        "gmtDeleteTime": null,
        "deleteSalesId": null,
        "deleteSalesName": null,
        "salesDeptNames": "[\"探马企服/西瓜的部门\"]"
      }
    ]
  }
}