获取客户列表接口
该接口用于获取应用的权限范围内的客户列表,调用该接口需要有客户列表的权限。
请求方式:GET(HTTPS)
请求地址:/open/customer/get_customer_list?access_token=asdad154ad5545ad5d445a4d56a
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 授权凭证,参考:access_token接口 |
username | 是 | 账号 |
enterprise_class | 否 | 客户类型。默认全部 1企业客户、2个人客户、3全部 |
teams | 否 | 查询范围。默认个人 1个人、2团队、3全部 |
page_size | 否 | 每次返回的客户数,默认100条,每次最多返回200条 |
offset | 否 | 从第几条开始返回,默认从第1条 |
start_time | 否 | 按修改时间查询。开始时间(时间戳) |
end_time | 否 | 按修改时间查询。结束时间(时间戳) |
返回结果:
{
"code": 0,
"msg": "ok",
"data": [{
"id": "aToxMjs",
"customer_name": "XX科技有限公司",
"province": "xx省",
"city": "xx市",
"area": "xx区",
"address": "xx街道",
"level": "潜在客户",
"type": "经销商",
"source": "线索转化",
"industry": "建筑业/房地产业",
"main_product": "赢在销客CRM",
"scope": "1-10人",
"url": "www.wininsales.com",
"status": "0",
"enterprise_id": "1",
"create_user": "1",
"create_time": "1582870376",
"memo": "备注",
"tel": "",
"fax": "",
"last_contact_time": "",
"label": "",
"enterprise_class": "1",
"phone": "",
"email": "",
"qq": "",
"wechat": "",
"sex": "2",
"birthday": "",
"share_truename": "",
"charge_truename": "",
"cooperater": "",
"field": {
"单店营业额": "",
"年总营业额": ""
},
},
{
"id": "aToxMjs",
"customer_name": "XX科技有限公司",
"province": "xx省",
"city": "xx市",
"area": "xx区",
"address": "xx街道",
"level": "潜在客户",
"type": "经销商",
"source": "线索转化",
"industry": "建筑业/房地产业",
"main_product": "赢在销客CRM",
"scope": "1-10人",
"url": "www.wininsales.com",
"status": "0",
"enterprise_id": "1",
"create_user": "1",
"create_time": "1582870376",
"memo": "备注",
"tel": "",
"fax": "",
"last_contact_time": "",
"label": "",
"enterprise_class": "1",
"phone": "",
"email": "",
"qq": "",
"wechat": "",
"sex": "2",
"birthday": "",
"share_truename": "",
"charge_truename": "",
"cooperater": "",
"field": {
"单店营业额": "",
"年总营业额": ""
},
}]
}
参数说明:
参数 | 说明 |
---|---|
code | 出错返回码,为0表示成功,非0表示调用失败 |
msg | 返回码提示语 |
data | 返回的业务数据 |
∟id | 客户唯一标识 |
∟customer_name | 客户名称 |
∟province | 所属省份 |
∟city | 所属市 |
∟area | 所属区 |
∟address | 所属街道 |
∟level | 客户等级 |
∟type | 客户类型 |
∟source | 客户来源 |
∟industry | 所属行业 |
∟main_product | 主营产品 |
∟scope | 规模 |
∟url | 官网地址 |
∟status | 客户状态 0正常 -1删除 |
∟enterprise_id | 所属企业 |
∟create_user | 创建者 |
∟create_time | 创建时间 |
∟memo | 备注 |
∟tel | 座机 |
∟fax | 传真 |
∟last_contact_time | 最后联系时间(时间戳) |
∟label | 客户标签 |
∟customer_class | 客户类型 1企业客户 2个人客户 |
∟phone | 手机 |
邮箱 | |
微信 | |
∟sex | 性别 1男 2女 |
∟birthday | 生日 |
∟share_truename | 共享者 |
∟charge_truename | 主跟进者 |
∟cooperater | 协作者 |
∟field | 自定义字段 |