API开发文档 - 道一云

开发说明

开发说明

功能说明：获取到商机信息
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/crmAction/getBusinessInfo.do?token=token&corpId=corpId

请求包体：

{
	"currentPage":1,
	"endTime":"2017-01-31",
	"pageSize":100,
	"startTimes":"2017-01-01"
}

请求参数说明：

参数	说明	类型	是否必须	备注
token	用于验证	String	是	详见道一云平台TOKEN接口文档
corpId	公司唯一标识	String	是	企业corpId
startTimes	创建时间开始点	String	是	时间格式为yyyy-MM-dd
endTime	创建时间结束点	String	是	创建时间间隔不的超过两个月
currentPage	查询页码	int	是	必须为正整数,如果当前页超过最大页数,则当前页默认为最大页
pageSize	分页大小	int	否	默认为100,并且不超过1000

SDK调用示例：

		// 创建请求的参数
		CrmDataPush vo = new CrmDataPush();
		// 设置当前页面
		vo.setCurrentPage(1);
		// 设置页面大小
		vo.setPageSize(10);
		// 设置要查询商机的时间范围（不超过两个月）
		vo.setStartTimes("2019-11-01");
		vo.setEndTime("2019-11-07");
		System.out.println(JSONUtil.stringify(vo));
		CrmApi api = QwSdkUtil.getInter(CrmApi.class);
		// 调用接口
		CrmBusinessInfoPageResult businessInfo = api.getBusinessInfo(
				QwSdkUtil.getCacheToken(), vo);
		System.out.println(JSONUtil.stringify(businessInfo));

返回结果：

{
  "code": "0",
  "desc": "成功",
  "data": {
    "currentPage": 1,
    "pageSize": 100,
    "maxPage": 1,
    "totalRows": 10,
    "pageData": [
      {
        "id": "b4ae8aec-e726-453d-b087-19732a3a8f11",
        "title": "道一云平台_商机",
        "content": "道一云平台",
        "clientName": "道一云",
        "clientCode": "20160901151232",
        "contactName": "道一云平台",
        "stage": "初步交流",
        "businessType": "类别1",
        "estimatedSale": "999.0",
        "estimatedDate": "2017-04-22 19:20:00.0",
        "createTime": "2017-04-22 19:25:56.0",
        "personName": "道一云",
        "creator": "f2a9beef9ebe0c86861002953e31fd8f",
        "wxUserId": "qiwei",
        "departmentName": "道一云科技->产品设计;道一云测试",
        "ccPersonNames": "道一,道一云",
        "ccPersonIds": "do1,qiwei",
        "relativePersonNames": "道一,道一云",
        "relativePersonIds": "do1,qiwei",
        "updateTime": "2017-04-22 19:25:56.0",
        "comment": "【道一云】,【已阅】,【2016-12-07】\r\n",
        "optionMap": {
          "选项": "选项1",
          "日期": "2018-02-01 14:04",
          "联系电话": "134302xxxxx",
          "单行文本": "xxxxx",
          "多行文本": "xxxxx"
        },
        "loseReasonDesc": "",
        "loseReasonId": ""
      }
    ]
  }
}

返回参数说明：

参数	说明
currentPage	当前页
pageSize	分页大小
maxPage	最大页
totalRows	信息总条数

list参数	说明
id	商机ID
title	标题
content	内容
clientName	客户名称
clientCode	客户代码
contactName	联系人名称
stage	商机阶段
businessType	商机类别
estimatedSale	销售金额
estimatedDate	结单日期
createTime	创建时间
personName	创建人
creator	创建人Id
wxUserId	创建人账号
departmentName	所属部门
ccPersonNames	负责人名称
ccPersonIds	负责人账号
relativePersonNames	相关人名称，两个以上用英文逗号“,”隔开
relativePersonIds	相关人账号，两个以上用英文逗号“,”隔开
updateTime	更新时间
comment	审批/评论信息
loseReasonId	输单原因id
loseReasonDesc	输单原因描述
optionMap	自定义字段键值对

企业微信

获取商机信息列表

开发说明