發放道具(可選)
作用
通過請求原廠的API接口,對玩家角色進行發放道具的操作。
該接口用於遊戲所有儲值管道的發放道具操作。
基本參數包括:物品類型(elementType),物品編號(elementId),物品數量(count),平臺ID(userId),郵件標題(title),郵件內容(content),伺服器CODE(serverCode),當前時間戳(timeStamp),MD5簽名(sign)。
功能變數名稱由原廠和我們產品協商而定。sign簽名裏面的KEY值(如:8~32位長度,大小寫字母或数字,不含特殊符号),可由PM提供。完成處理流程

請求URL(需要支持post和get方式,建議優先POST)[默认application/x-www-form-urlencoded] 域名路徑(需要廠商提供) 如:http://xxx.xxx.com/user/sendProps 測試伺服器鏈接 如:
java
http://xxx.xxx.com/user/sendProps?elementType=1&elementId=0&userId=3258506&count=1&serverCode=ld4&timeStamp=1378456412008&roleId=12045897&sign=1faec808b862af2d5a726f993477529b&title=abc&content=12334請求參數
| 參數說明 | ||
|---|---|---|
| serverCode | 伺服器CODE | 必填 |
| userId | 用戶ID | 必填 |
| elementType | 發放物品類型 如:elementType:卡牌=1 金幣=3裝備=5 卡卷=7神鐵=6 鑽石=9英雄=8 精華=12英雄魂=10 奧塵=13卡魂=14 龍血=16 | 選填 |
| elementId | 發放物品編號[對應資料裏可查] 如:當elementType為卡牌,裝備,神鐵,卡魂,英雄,英雄魂時 elementId為物品編號,為其他類型時elementId填寫0 | 必填 |
| count | 發放物品數量 | 必填 |
| timeStamp | 時間戳 【精确到秒】 | 必填 |
| sign | 簽名MD5(serverCode + userId + elementType + elementId + count + 活动KEY(如:8~32位長度,大小寫字母或数字,不含特殊符号)+ timeStamp) | 必填 |
| title | 郵件標題 | 選填 |
| content | 郵件內容 | 選填 |
| roleId | 角色ID | 選填 |
返回結果
| 返回結果(標準JSON格式) | ||
|---|---|---|
| 成功 | {"ret":0, "msg":"ok"} | ret:0 接收成功 |
| 失敗 | {"ret":1001, "msg":"參數錯誤"} | ret非0為錯誤,注:如有定義錯誤編碼說明,煩告知 |
返回結果 JSON 字段說明
| 參數說明 | ||
|---|---|---|
| ret | 返回狀態 | 必需返回 |
| msg | 返回資訊說明 | 必需返回 |
錯誤編碼說明
1001 參數錯誤 1002 不存在的用戶 1003 sign錯誤 1004 重覆提交 1008 帳號已禁用 65535 服務器錯誤