Skip to content

發放道具(可選) ​

作用 ​

通過請求原廠的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 服務器錯誤