获取指定用户信息
接口id
108(service_id = 108)
说明
- 此接口由接入方提供,众趣方通过开放平台调用。
- 当带看业务需要展示指定用户(带看发起方、经纪人、参与方等)的展示用资料(头像、姓名、角色等)时,通过本接口由客户服务器查询返回。
- 接口验证规则请参考 回调接口规则说明。区别于回调接口,此接口使用
request_id而不是callback_id,含义一致。
接口提供
接入方需要提供此接口地址,参照如下规则给到众趣方:
https://customer.com/test/api/user_info/?app_id=xxx&app_secret=yyy
入参示例:
请求方法:GET
https://customer_host.com/api/user_info/?user_id=1448291745301000000&app_id=1345×tamp=1532059200000&sign=edb7a6c92c4284fb7e825d63e7258b95&request_id=877602611346546688
入参参数说明:
| 参数名 | 数据类型 | 是否必传 | 参数说明 |
|---|---|---|---|
| user_id | string | 是 | 客户侧的用户 ID |
| app_id | string | 是 | 校验用,参考回调接口规则 |
| timestamp | string | 是 | 校验用,参考回调接口规则 |
| sign | string | 是 | 校验用,参考回调接口规则 |
| request_id | string | 是 | 校验用,参考回调接口规则的 callback_id 字段 |
返回参数示例:
{
"code": 1,
"msg": "success",
"data": {
"UserId": "1448291745301000000",
"UserName": "刘宝",
"Avatar": "https://customer_host.com/avatar/1448291745301000000.png",
"RoleId": "1",
"RoleName": "经纪人",
"PhoneNumber": "18682300000",
"ElectronicCard": "https://customer_host.com/card/1448291745301000000.html"
}
}
返回参数说明:
成功时 data 字段中建议返回如下信息,具体字段以贵我双方约定为准:
| 字段名 | 数据类型 | 是否必传 | 参数说明 |
|---|---|---|---|
| UserId | string | 是 | 用户 ID(与入参 user_id 对应) |
| UserName | string | 是 | 用户姓名(带看页面展示用) |
| Avatar | string | 否 | 头像 URL |
| RoleId | string | 否 | 角色 ID |
| RoleName | string | 否 | 角色名称 |
| PhoneNumber | string | 否 | 联系电话 |
| ElectronicCard | string | 否 | 电子名片地址 |
备注
- 客户响应需符合 回调接口规则说明 中"回调接口的响应值"约定(
code=1表示成功)。