获取客户列表接口
该接口用于获取应用的权限范围内的客户列表,调用该接口需要有客户列表的权限。
请求方式: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 | 自定义字段 |