Skip to content

用戶角色查詢(必接) ​

作用 ​

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

處理流程圖展示 ​

請求URL(需要支持post和get方式,建議優先POST)[默认application/x-www-form-urlencoded] 域名路徑(需要廠商提供) 如:http://xxxx.xxxxxx.com/user/info 測試伺服器鏈接 如:

java
http://xxxx.xxxxxx.com/user/info?userId=3258506&serverCode=1&timestamp=1378456412008&sign=1faec808b862af2d5a726f993477529b

請求參數說明 ​

參數說明
userId用戶ID必填
serverCode儲值伺服器CODE必填
timestamp時間戳 【精确到秒】必填
sign簽名 加密規則MD5(userId+serverCode+角色KEY+timestamp)角色KEY: 雙方事先約定的保密的值(如:8~32位長度,大小寫字母或数字,不含特殊符号)必填

返回結果 ​

返回結果(標準JSON格式)
成功{"ret":0,"msg":"ok","data":[{"roleId":120,"level":30,"nick":"角色1"},{"roleId":123,"level": 31,"nick":"角色2"}]}ret:0 接收成功
失敗{"ret":1001, "msg":"參數錯誤"}ret非0為錯誤,注:如有定義錯誤編碼說明,煩請告知

返回結果 JSON 字段說明 ​

返回參數說明
ret返回狀態必需返回
msg返回資訊說明必需返回 ; (注意:返回msg建議真實準確說明錯誤原因,不建議如userId錯誤也用system busy原因)
data角色資訊體 數組形式,如 "data":[{"roleId":120,"level":30,"nick":"角色1"},{"roleId":123,"level":31,"nick":"角色2"}]ret非0(则失败时)-不需返回
roleId角色ID(存在角色時 必需返回)ret為0-必需返回 ret非0(则失败时)-不需返回
nick角色名稱(存在角色時 必需返回)ret為0-必需返回 ret非0(则失败时)-不需返回
level角色等級(存在角色時 必需返回)ret為0-必需返回 ret非0(则失败时)-不需返回

錯誤編碼說明 ​

1001 參數錯誤 1002 不存在用戶 1003 sign錯誤 1008 帳號已禁用 65535 服務器錯誤