customercontacts/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取客户联系人
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
基础数据同步或前端展示
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/customercontacts/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | sting | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| code_begin | 否 | string | 起始联系人编码 |
| code_end | 否 | string | 结束联系人编码 |
| name | 否 | string | 联系人名称关键字 |
| ccuscode | 否 | string | 所属客户编码 |
| ccusname | 否 | string | 所属客户名称关键字 |
| direct_leader_code | 否 | string | 直接上级编码 |
| direct_leader | 否 | string | 直接上级关键字 |
| charge_person_code | 否 | string | 负责人编码 |
| charge_person | 否 | string | 负责人关键字 |
| be_main_linker | 否 | boolean | 主要联系人 |
| title | 否 | string | 称呼 |
| sex | 否 | string | 性别 |
| birthday | 否 | date | 生日 |
| position | 否 | string | 职位 |
| mobile_phone | 否 | string | 手机号 |
| office_phone | 否 | string | 办公电话 |
| 否 | string | email关键字 | |
| favorite | 否 | string | 个人爱好关键字 |
| 否 | string | 微信号关键字 | |
| 否 | string | QQ号 | |
| default | 否 | boolean | 默认联系人 |
3.3请求示例
GET https://api.yonyouup.com/api/customercontacts/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&code_begin=xxxxx&code_end=xxxxx&name=xxxxx&ccuscode=xxxxx&ccusname=xxxxx&direct_leader_code=xxxxx&direct_leader=xxxxx&charge_person_code=xxxxx&charge_person=xxxxx&be_main_linker=xxxxx&title=xxxxx&sex=xxxxx&birthday=xxxxx&position=xxxxx&mobile_phone=xxxxx&office_phone=xxxxx&email=xxxxx&favorite=xxxxx&wechat=xxxxx&qq=xxxxx&default=xxxxx
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| code | string | 联系人编码 | |
| name | string | 联系人名称 | |
| ccuscode | string | 所属客户编码 | |
| ccusname | string | 所属客户名称 | |
| direct_leader_code | string | 直接上级编码 | |
| direct_leader | string | 直接上级 | |
| charge_person_code | string | 负责人编码 | |
| charge_person | string | 负责人 | |
| be_main_linker | boolean | 主要联系人 | |
| title | string | 称呼 | |
| sex | string | 性别 | |
| birthday | date | 生日 | |
| native | string | 籍贯 | |
| default | boolean | 默认联系人 | |
| position | string | 职位 | |
| mobile_phone | string | 手机号 | |
| office_phone | string | 办公电话 | |
| string | |||
| favorite | string | 个人爱好 | |
| string | 微信号 | ||
| string | QQ号 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"20",
"row_count":"225",
"errmsg":"",
"customercontacts":[
{
"position":"",
"direct_leader":"",
"birthday":"",
"sex":"不详",
"direct_leader_code":"",
"charge_person":"崔可",
"code":"00000007",
"ccusname":"天津鹏程电子有限公司",
"favorite":"",
"mobile_phone":"",
"title":"",
"default":"1",
"charge_person_code":"00040",
"native":"",
"email":"",
"be_main_linker":"1",
"ccuscode":"0215",
"name":"张天宇",
"wechat":"",
"office_phone":""
},
{
"position":"",
"direct_leader":"",
"birthday":"",
"sex":"不详",
"direct_leader_code":"",
"charge_person":"师小容",
"code":"00000012",
"ccusname":"云飞电子科技集团",
"favorite":"",
"mobile_phone":"",
"title":"",
"default":"1",
"charge_person_code":"00023",
"native":"",
"email":"",
"be_main_linker":"1",
"ccuscode":"0111",
"name":"阚奇",
"wechat":"",
"office_phone":""
}
],
"page_count":"12",
"errcode":"0"
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode":"30021",
"errmsg":"此应用未上线"
}