用戶角色查詢(按 roleId,可選)
作用
通過請求原廠的API接口,獲取玩家角色的資訊。
該接口一般用於頁面儲值,第三方儲值和補點前,需要查詢玩家的角色資訊,再進行儲值操作。
基本參數包括:角色ID(roleId),當前時間戳(timestamp),MD5簽名(sign)。
功能變數名稱由原廠和我們產品協商而定。sign簽名裏面的KEY值(如:8~32位長度,大小寫字母或数字,不含特殊符号),只要保密自定義好則可,可由PM提供。處理流程圖展示

請求URL(需要支持post和get方式,建議優先POST)[默认application/x-www-form-urlencoded] 域名路徑(需要廠商提供) 如:http://xxxx.xxxxxx.com/role/info 測試伺服器鏈接 如:
java
http://xxxx.xxxxxx.com/role/info?roleId=3258506&timeStamp=1378456412008&sign=1faec808b862af2d5a726f993477529b請求參數說明
| 參數說明 | ||
|---|---|---|
| roleId | 角色ID | 必填 |
| timestamp | 時間戳【精确到秒】 | 必填 |
| sign | 簽名 加密規則MD5(roleId+角色KEY+timestamp) 角色KEY: 雙方事先約定的保密的值(如:8~32位長度,大小寫字母或数字,不含特殊符号) | 必填 |
返回結果
| 返回結果(標準JSON格式) | ||
|---|---|---|
| 成功 | {"ret":0,"msg":"ok","data":{"userid":"3520001","roleName":"角色1","serverName":"伺服1","serverId":"1001","level":30}} | ret:0 接收成功 |
| 失敗 | {"ret":1001, "msg":"參數錯誤"} | ret非0為錯誤,注:如有定義錯誤編碼說明,煩請告知 |
返回結果 JSON 字段說明
| 返回參數說明 | ||
|---|---|---|
| ret | 返回狀態 | 必需返回 |
| msg | 返回資訊說明 | 必需返回 ; (注意:返回msg建議真實準確說明錯誤原因,不建議如userId錯誤也用system busy原因) |
| data | 角色資訊體 數組形式,如 "data":{"userid":"3520001","roleName":"角色1","serverName":"伺服1","serverId":"1001","level":30} | ret非0(则失败时)-不需返回 |
| userid | 角色對應的平臺用戶id(存在角色時 必需返回) | ret為0-必需返回 ret非0(则失败时)-不需返回 |
| roleName | 角色名稱(存在角色時 必需返回) | ret為0-必需返回 ret非0(则失败时)-不需返回 |
| serverId | 伺服ID(存在角色時 必需返回) 注意:廠商serverId必須跟我方約定的伺服器serverCode對應上,否則會檢驗不通過 | ret為0-必需返回 ret非0(则失败时)-不需返回 |
| serverName | 伺服名稱(存在角色時 必需返回) | ret為0-必需返回 ret非0(则失败时)-不需返回 |
| level | 角色等級(存在角色時 必需返回) | ret為0-必需返回 ret非0(则失败时)-不需返回 |
錯誤編碼說明
貴方自定義,ret非0 都是錯誤code