获取往来列表接口
该接口用于获取应用的权限范围内的往来列表,调用该接口需要有往来列表的权限。
请求方式:GET(HTTPS)
请求地址:/open/visit/get_visit_list?access_token=asdad154ad5545ad5d445a4d56a
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 授权凭证,参考access_token接口 |
username | 是 | 账号 |
teams | 否 | 查询范围。默认全部 1个人、2团队、3全部 |
page_size | 否 | 每次返回的联系人数,默认100条,每次最多返回200条 |
offset | 否 | 从第几条开始返回,默认第1条 |
start_time | 否 | 按修改时间查询。开始时间(时间戳) |
end_time | 否 | 按修改时间查询。结束时间(时间戳) |
返回结果:
{
"code": 0,
"msg": "ok",
"data": [
{
"id": "czo0OiI2NTQwIjs",
"contact_id": "czo1OiI0OTQ1OSI7",
"clue_id": "0",
"type": "客户面访",
"expect_start_time": "1589371020",
"expect_end_time": "1589378220",
"actual_start_time": null,
"actual_end_time": null,
"visit_address": "黄浦区黄浦区五里桥永业仁德坊(斜土路南)",
"expect_memo": "阿萨斯大所大所大所",
"actual_memo": null,
"status": "0",
"create_user": "赵尔征",
"create_time": "1589363863",
"submit_time": "1589363863",
"contact_way": null,
"belong_user": "赵尔征",
"belong_time": "1589363863",
"sign_status": "0",
"sign_time": null,
"sign_content": null,
"visit_sign_address": null,
"contact_name": "李华",
"enterprise_id": "45",
"customer_id": "czo1OiIzNTA5MyI7",
"memo": "阿萨斯大所大所大所",
"product": []
},
{
"id": "czo0OiI2NTQwIjs",
"contact_id": "czo1OiI0OTQ1OSI7",
"clue_id": "0",
"type": "客户面访",
"expect_start_time": "1589371020",
"expect_end_time": "1589378220",
"actual_start_time": null,
"actual_end_time": null,
"visit_address": "黄浦区黄浦区五里桥永业仁德坊(斜土路南)",
"expect_memo": "阿萨斯大所大所大所",
"actual_memo": null,
"status": "0",
"create_user": "赵尔征",
"create_time": "1589363863",
"submit_time": "1589363863",
"contact_way": null,
"belong_user": "赵尔征",
"belong_time": "1589363863",
"sign_status": "0",
"sign_time": null,
"sign_content": null,
"visit_sign_address": null,
"contact_name": "李华",
"enterprise_id": "45",
"customer_id": "czo1OiIzNTA5MyI7",
"memo": "阿萨斯大所大所大所",
"product": []
}
]
}
参数说明:
参数 | 说明 |
---|---|
id | 往来唯一标识 |
contact_id | 联系人唯一标识 |
clue_id | 关联商机唯一标识 |
type | 往来类型 |
expect_start_time | 预计开始时间 |
expect_end_time | 预计结束时间 |
actual_start_time | 实际开始时间 |
actual_end_time | 实际结束时间 |
visit_address | 往来地址 |
expect_memo | 预计沟通内容 |
actual_memo | 实际沟通内容 |
status | 状态;-2:取消计划,-1:草稿,0:正常,1:提交 |
create_user | 创建人 |
create_time | 创建时间 |
submit_time | 提交时间 |
contact_way | 联系方式 |
belong_user | 归属人 |
belong_time | 归属时间 |
sign_status | 签到状态。0未签到1签到 |
sign_time | 签到时间 |
sign_content | 签到备注 |
visit_sign_address | 实际签到地址 |
contact_name | 联系人姓名 |
enterprise_id | 企业id |
customer_id | 客户唯一标识 |
memo | 备注 |
product | 往来产品 |