customercontacts/get
目录 |
1.接口说明
1.1接口描述
获取单个客户联系人
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
基础数据同步或前端展示
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/customercontacts/get |
| 格式 | JSON |
| https请求方式 | GET |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | sting | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| id | 是 | string | 联系人编码 |
3.3请求示例
GET https://api.yonyouup.com/api/customercontacts/get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&id=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
{
"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":""
},
"errcode":"0"
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode":"30021",
"errmsg":"此应用未上线"
}