API开发文档 - 道一云

开发说明

开发说明

功能说明：获取到拜访信息
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/crmAction/getOutsideWorkInfo.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("2017-01-01");
		vo.setEndTime("2017-02-01");
		System.out.println(JSONUtil.stringify(vo));
		CrmApi api = QwSdkUtil.getInter(CrmApi.class);
		// 调用接口
		CrmWorkInfoPageResult workInfo = api.getOutsideWorkInfo(
				QwSdkUtil.getCacheToken(), vo);
		System.out.println(JSONUtil.stringify(workInfo));

返回结果：

{
  "code": "0",
  "desc": "成功",
  "data": {
    "currentPage": 1,
    "pageSize": 100,
    "maxPage": 1,
    "totalRows": 7,
    "pageData": [
      {
        "id": "fac6778d-b4eb-49c4-be4d-9057f5c4b79d",
        "clientName": "道一云平台",
        "contactName": "道一云平台",
        "outworkTime": "2016-11-01 16:39:00.0",
        "outworkTitle": "道一云拜访单_201611011639",
        "outworkContent": "参观客户公司",
        "oswgdTitle": "道一云外勤_201611011640",
        "address": "天河区员村一横路3号华颖轩",
        "clientAddress": "天河区员村一横路3号华颖轩",
        "status": "1",
        "personName": "企小薇",
        "wxUserId": "qiwei",
        "departmentName": "道一信息->道一云开发部",
        "createTime": "2016-11-01 16:39:55.0",
        "ccPersonNames": "企小薇,企大微",
        "ccPersonIds": "qiwei,dawei",
        "relativePersonNames": "企小薇,企大微",
        "relativePersonIds": "qiwei,dawei",
        "comment": "【小道】,【已阅】,【2016-11-02】\r\n",
        "optionMap": {
          "选项": "选项1",
          "日期": "2018-02-01 14:04",
          "联系电话": "134302xxxxx",
          "单行文本": "xxxxx",
          "多行文本": "xxxxx"
        }
      }
    ]
  }
}

返回参数说明：

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

pageData参数	说明
id	拜访单ID
clientName	客户名称
contactName	联系人名称
outworkTime	拜访时间
outworkTitle	标题
outworkContent	内容
oswgdTitle	所属外勤单
address	地址
clientAddress	客户地址
imageUrl	图片
status	0:草稿 1:已提交
personName	创建人
wxUserId	创建人账号
departmentName	所属部门
createTime	创建时间
ccPersonNames	负责人名称，两个以上用英文逗号“,”隔开
ccPersonIds	负责人账号，两个以上用英文逗号“,”隔开
relativePersonNames	相关人名称，两个以上用英文逗号“,”隔开
relativePersonIds	相关人账号，两个以上用英文逗号“,”隔开
comment	审批/评论信息，两个以上用英文逗号“,”隔开
optionMap	自定义字段键值对

企业微信

获取拜访信息列表

开发说明