#
简要描述
- 获取用户信息
请求URL
- 分为测试环境和生产环境,需要通知Sud分别进行配置
- 生产环境地址需要正式上线部署后才能生效
请求方式
- https
- POST
- 参数为Json格式,放在body内
回调验签
客户服务端需对回调内容进行验签,保证数据的完整性。
请求参数(可能会新增加字段,请接入方保持新增加字段兼容性)
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
ss_token | 是 | string | token |
请求示例
{
"ss_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiIxMjMiLCJleHAiOjE2MzA0MTc4NDksImFwcF9pZCI6ImFwcElEIn0.BWFAf7-Bi20KsFIjnQcF2ET1RNhoZRhoWa-VOxYbPuY"
}
返回参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
ret_code | 是 | int32 | 错误码,0:成功,其他表示错误 |
ret_msg | 是 | string | 错误信息 |
sdk_error_code | 否 | int32 | sdk错误码,0:成功,其他表示错误 |
data | 是 | object | data数据 |
data 参数说明
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
uid | 是 | string | 用户id |
nick_name | 是 | string | 用户昵称 |
avatar_url | 是 | string | 用户头像url(建议使用128*128尺寸) |
gender | 是 | string | 性别(female or male or "") 未知性别请填写空字符串 |
is_ai | 否 | int32 | 0:普通用户,1:机器人(默认为0) |
ai_level | 否 | int32 | ai等级 0:简单ai 1:简单ai 2:中级ai 3:高级ai 默认为0 |
正确返回示例
{
"ret_code": 0, //错误码,0为成功,其他错误
"ret_msg": "",
"sdk_error_code":0,//sdk错误码,0为成功,其他错误
"data": {
"uid": "1380100177150345266",
"nick_name": "萌萌",
"avatar_url": "https://icon.png?128*128",
"gender": "female",
"is_ai": 0,
"ai_level": 0
}
}
错误码返回示例
{
"ret_code": 1, //错误码,0为成功,其他错误
"ret_msg": "",
"sdk_error_code":1005,//sdk错误码,0为成功,其他错误
"data": {
"uid": "1380100177150345266",
"nick_name": "萌萌",
"avatar_url": "https://icon.png?128*128",
"gender": "female"
}
}