用戶信息獲取接口 · 短說對接技術文檔1.0

# 用戶信息獲取接口 # 注意：該接口由開發者在開發者服務端實現，供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短說概不負責。