|
开放平台
此接口是在商家获取用户的open_id后,希望进一步获取用户的相关信息时使用.
https://openapi.guanaitong.tech/seller/person/getDetailByOpenId
POST
(1)公共参数
发送请求是必须传入公共参数，详见公共参数
(2)私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
| open_id | 是 | string | 32 | 员工唯一标识 |
POST /seller/person/getDetailByOpenId HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=8aaca96efff711e5634b720fd9c68b99&sign=0ed7381358e8f3471e186804b1bee7e544ff9f59&
timestamp=1529046657&auth_code=555f80990ba173b95ddad6e83796e9c5
注:由于授权字段会根据授权情况进行返回，故接收方如使用jackson需要考虑接收对象的兼容问题，可加上注解 @JsonIgnoreProperties(ignoreUnknown = true)
| 参数名称 | 描述 |
| code | 返回码。详见错误返回码。 |
| msg | 如果错误，返回错误信息。 |
| data | 如果没有错误，返回业务数据 |
| data.open_id | 员工唯一标识 |
| data.enterprise_open_id | 员工所属企业的唯一标识 |
| data.enterprise_name | 员工所属企业的名称(如需返回该字段请联系管理员) |
| data.name | 员工姓名 (如需返回该字段请联系管理员) |
| data.code | 员工工号 (如需返回该字段请联系管理员) |
| data.portrait | 员工头像地址 (如需返回该字段请联系管理员) |
| data.sex | 员工性别 1男 2女 3其他 (如需返回该字段请联系管理员) |
| data.mobile_area | 手机号区号 (如需返回该字段请联系管理员) |
| data.mobile | 员工手机号 (如需返回该字段请联系管理员) |
| data.birth_day | 员工生日 格式yyyy-MM-dd (如需返回该字段请联系管理员) |
| data.email | 员工邮箱 (如需返回该字段请联系管理员) |
| data.department | 员工所属部门名称 (如需返回该字段请联系管理员) |
| data.fixed_phone | 员工座机 (如需返回该字段请联系管理员) |
| data.join_date | 员工入职日期 (如需返回该字段请联系管理员) |
| data.enterprise_id | 员工所属企业的标识(如需返回该字段请联系管理员) |
| data.id_info | 员工身份信息(如需返回该字段请联系管理员，返回是json格式，card_type 是证件类型，1-身份证，2-护照，3-香港居民身份证，4-澳门居民身份证，5-台湾身份证，6-台胞证，7-回乡证)，card_no是具体证件号码 |
| data.category | 员工分类 |
| data.level | 员工级别 |
{
"code": 0,
"data": {
"open_id": "555f80990ba173b95ddad6e83796e9c5",
"enterprise_open_id": "4c81084dc654c81fc1aa4b0799a4dfa9",
"enterprise_name": "XX有限公司",
"name": "张三",
"code": "HB001"
},
"msg": "OK"
}
{
"code": 1000210001,
"msg": "timestamp check failed!",
"data": null
}