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

請求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温馨提示:
发预注册的道具使用的实际上是另一菜单栏目的发道具[可选]接口一样的。
可以理解成发预注册的奖励是一种特定约定的奖励code;請求參數
| 參數說明 | ||
|---|---|---|
| serverCode | 伺服器CODE | 必填 |
| userId | 用戶ID | 必填 |
| elementType | 双方约定预注册的类型,如:0 | 必填 |
| elementId | 双方约定预注册的奖励編號,如:99999 | 必填 |
| count | 双方约定预注册的發放物品數量,如: 1 | 必填 |
| 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 服務器錯誤