# 用户信息获取接口
# 注意：该接口由开发者在开发者服务端实现，供OSX短说调用
### OSX短说后台填写接口地址
```
<pre class="calibre26">
```
https://[接口地址] 如：https://my.apk.com/getUserInfo
```
```
#### 请求参数约定(Get请求方式传参)
参数 是否必须 参数类型 限制长度 参数说明 user\_token 是 string 255 用户唯一性标识，对应唯一一个用户且不可变 token 是 string 255 免登陆url中携带的请求有效性标识<br/>**如该值传入'not\_login',说明该次请求不属于登录流程的一部分，不要做token有效性验证** appKey 是 string 255 接口appKey，应用的唯一标识(OSX后台获取) endtimestamp 是 String 20 请求有效期，截止有效时间。1970-01-01开始的时间戳，秒为单位。 sign 是 string 255 MD5签名，详见[【签名校验规则】](http://oa.xiangtian.ren/index.php?mod=corpus&op=list&cid=58#fid_618)#### 接口返回json格式示例
\> **json格式中主要包含data字段，data字段下是user\_token、userInfo 分别保存了用户唯一标识以及用户信息**
```
<pre class="calibre26">
```
{
"code":200,
"msg":"ok",
"data":{
"user_token":"用户唯一标识",
"userInfo":{
"nickname":"用户昵称",
"phone":"用户手机号",
"avatar":'头像地址',
"real_name":'真实姓名',
"sex":" 性别，0：保密，1：男，2：女 ",
"birthday":"生日，1970-01-01开始的时间戳，秒为单位",
"qq":'qq号',
"signature":'个性签名，个人心情、状态描述',
"score1":"exp，经验值。等级可由经验值换算，换算规则可在OSX短说后台配置",
"score2":"社区积分",
"score3":"购物积分",
"score4":'贡献值',
"score5":'自定义积分类型1',
"score6":'自定义积分类型2',
"score7":'自定义积分类型3',
"score8":'自定义积分类型4',
"score9":'自定义积分类型5'
}
}
}
```
```
```
<pre class="calibre26">
```
{
"code":200,
"msg":"error",
"data":"请求失败,参数不正确"
}
```
```
#### 返回参数约定（OSX短说会根据返回的参数名列表更新OSX平台上对应用户信息）
参数 是否必须 参数类型 限制长度 参数说明 msg 是 string 255 操作结果的判断标识，‘ok’:本次请求成功；‘error’:本次请求失败 data 是 string 255 返回数据，请求失败时，这里保存失败原因说明 data.user\_token 是 string 255 用户唯一标识 data.userInfo.nickname 是 string 25 用户昵称 data.userInfo.phone 否 string 20 用户手机号 data.userInfo.avatar 否 String 255 头像地址 data.userInfo.real\_name 否 string 25 真实姓名 data.userInfo.sex 否 int 2 性别，0：保密，1：男，2：女 data.userInfo.birthday 否 int 11 生日，1970-01-01开始的时间戳，秒为单位 data.userInfo.qq 否 string 25 qq号 data.userInfo.signature 否 string 100 个性签名，个人心情、状态描述 data.userInfo.score1 否 string 25 exp，经验值。等级可由经验值换算，换算规则可在OSX短说后台配置 data.userInfo.score2 否 string 25 fly，社区积分 data.userInfo.score3 否 string 25 buy，购物积分 data.userInfo.score4 否 string 25 gong，贡献值 data.userInfo.score5 否 string 25 one，自定义积分类型1 data.userInfo.score6 否 string 25 two，自定义积分类型2 data.userInfo.score7 否 string 25 three，自定义积分类型3 data.userInfo.score8 否 string 25 four，自定义积分类型4 data.userInfo.score9 否 string 25 five，自定义积分类型5#### OSX短说实际调用接口地址示例:
```
<pre class="calibre26">
```
登录流程中：
https://osxbenew.demo.opensns.cn/getUserInfo?user_token=14359234985&token=dsfdlsjglfdsgjfkdsgfhsd&endtimestamp=1520559858&appKey=testappKey&sign=b55bacc9e7567e7ade52b7821fe4fb87
或
非登陆流程中：
https://osxbenew.demo.opensns.cn/getUserInfo?user_token=14359234985&token=not_login&endtimestamp=1520559858&appKey=testappKey&sign=0b1db39f6634a38a2c962bf930409a27
```
```
### 注意事项
1. OSX发起的请求默认会带上请求有效期、appKey以及sign签名；开发者服务端可以根据请求接口参数验证请求来源的安全性。如开发者服务端不做相关校验，将可能导致平台重要信息泄露，由此造成的损失OSX短说概不负责。
