- 开发指南
- 基础接口
- 客户设置
- 消息推送
- 客户&线索&待分配
- 客户查询
- 客户导入
- 客户
- 线索&待分配
- 商机
- 个人客户转企业客户
- 企业客户联系人
- 客户旅程
- 客户操作
- 按企微员工id列出企微好友客户详情POST
- 公海
- 企微组织架构
- 企微标签库
- 企业
- 合同
- 电商平台
- 营销
- 数据统计
- 内容访客
- 电销手机
- SOP任务
- 群发消息
- 管控
- 工单
- 素材
- 应用通知
- 附录
- 群数据
- 店主活码
- 通话列表
- 龙湖定制
获取商机列表
POST
/api/v3/opportunity/list
信息
请求参数
Header 参数
appId
string
应用 appId
默认值:
{{appId}}
timestamp
string
请求时间戳
默认值:
{{timestamp}}
sign
string
请求消息签名值
默认值:
{{sign}}
appKey
string
应用 appKey
默认值:
{{appKey}}
Body 参数application/json
salesIds
array[number]
销售id
departmentIds
array[number]
部门id
oppTypeId
number
商机类型id
customerAllocateSource
array[integer]
获取途径
customerSource
array[integer]
客户来源
channelState
array[string]
渠道来源
createRange
object
创建时间
startTime
string
开始时间
endTime
string
结束时间
turnoverRange
object
预计成交时间
startTime
string
必需
endTime
string
必需
dealRange
object
赢单时间
startTime
string
开始时间
endTime
string
结束时间
updateRange
object
更新时间
startTime
string
开始时间
endTime
string
结束时间
pageSize
integer
页码
pageNo
integer
页数
示例
{
"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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v3/opportunity/list' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"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"
}
}'返回响应
🟢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": "[\"探马企服/西瓜的部门\"]"
}
]
}
}修改于 2023-06-16 06:36:51