客户查询
- 接口：common/customers/v2/findByPage
- Method：GET
- 数据格式：json
- 接口说明：根据条件查询客户信息
1、最少有一个属性有值，不支持无条件查询
2、根据时间范围查询，start_datetime、end_datetime为必填字段，时间范围不超过7天
3、返回字段根据配置而定，不配置情况下只返回默认字段
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
| bizId |
String |
业务唯一识别码 |
true |
255 |
| timestamp |
long |
时间戳 |
true |
无 |
| data.page_num |
Integer |
分页页数 (最小1) |
true |
无 |
| data.page_size |
Integer |
分页条数 (最小1， 最大100) |
true |
无 |
| data.start_datetime |
long |
最后更新时间-开始时间(13位数字时间戳) |
true |
13 |
| data.end_datetime |
long |
最后更新时间-结束时间(13位数字时间戳) |
true |
13 |
| data.customer_code |
String |
客户编码 |
false |
255 |
| data.customer_name |
String |
客户名 |
false |
255 |
请求示例
{
"bizId" : "80801fe9-1630-482e-adb7-19a7e3a49fc6",
"timestamp" : 1591260596617,
"data": {
"page_num": 1,
"page_size": 20,
"start_datetime": 1523900290000,
"end_datetime": 1924490990000,
"customer_code": "test",
"customer_name": "test"
}
}
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| resCode |
Integer |
响应状态码（见附录） |
| resMsg |
String |
返回信息描述 |
| data.page_num |
Integer |
当前页数 |
| data.total_page |
Integer |
总页数 |
| data.page_size |
Integer |
分页条数 |
| data.total_count |
Integer |
总条数 |
| data.page_info |
Array |
数据结果列表 |
| data.page_info.code |
String |
客户编码 |
| data.page_info.language |
String |
语言参数 |
| data.page_info.enabled_flag |
String |
启用标记 |
| data.page_info.customer_name |
String |
客户名称 |
| data.page_info.contact_person |
String |
联系人 |
| data.page_info.contact_phone |
String |
联系电话 |
| data.page_info.contact_address |
String |
联系地址 |
| data.page_info.enabled_flag |
String |
是否被启用 |
返回示例
{
"resCode": 200000,
"resMsg": "success",
"data": {
"page_num": 1,
"total_page": 1,
"page_size": 2,
"total_count": 2,
"page_info": [
{
"code": "test-custome1",
"enabled_flag": "Y",
"customer_name": "**********",
"contact_person": "test1",
"contact_phone": "1675****7678",
"contact_address": "上海市浦东新区****"
},
{
"code": "test-custome2",
"enabled_flag": "Y",
"customer_name": "**********",
"contact_person": "test2",
"contact_phone": "1675****123",
"contact_address": "上海市浦东新区****"
}
]
}
}