# 自動發放禮包1.0接口文檔
### 一、游戲后臺操作
由cp在后臺配置好禮包道具信息，生成禮包碼提供游戲貓運營。
### 二、安全須知
直接發送禮包接口，不允許接入在游戲客戶端SDK，會暴露給玩家導致服務器攻擊或者加密規則破解。
禮包發放接口不包含業務邏輯，只要調用就會發放。如果出現網絡問題，或者其他情況導致請求失敗，需要接入方服務器有第補發和保護。
### 三、接口詳情
#### 1\. 獲得賬號下的所有服務器角色接口
**URL:** xxx/playerInfoByUin（接口路徑可自定義）
**HTTP請求方式：**GET
**請求參數：**
| **參數** | **必選** | **類型** | **說明** |
| --- | --- | --- | --- |
| uin | True | String | 游戲貓賬號唯一標識 |
**參數示例：**
http://{域名}/{api}?uin=123
**返回字段：**
| **參數** | **必選** | **類型** | **說明** |
| --- | --- | --- | --- |
| channelName | true | String | 渠道名稱 |
| channelId | true | String | 渠道編號 |
| players | false | String | 賬號下角色,可為空（內容見下方表格） |
| aid | true | String | 賬號編號 |
**players參數數據：**
| **參數** | **必選** | **類型** | **說明** |
| --- | --- | --- | --- |
| playerName | true | String | 角色名稱 |
| pid | true | String | 角色編號 |
| serverId | true | String | 服務器編號 |
| serverName | true | String | 服務器名稱 |
**返回示例：**
~~~
{
"channelName":?"聯運-龍騰服_iOS企業_游戲貓__凌天傳世",
"channelId":?"20514",
"players": [{
"playerName":?"騎牛撞交警",
"pid":?"63443",
"serverId":?"3426",
"serverName":?"龍騰1-15服"
}],
"aid":?"2563781"
}
~~~
#### 2\. 發送禮包接口
**URL:** xxx/sendEmailCodeCheck（接口路徑可自定義）
**HTTP請求方式：**POST
**請求參數（json格式的數據，raw形式發送）：**
| **參數** | **必選** | **類型** | **說明** |
| --- | --- | --- | --- |
| serverId | true | String | 服務器編號 |
| pid | true | String | 角色編號 |
| sid | true | String | 賬號編號 |
| code | true | String | 郵件兌換碼 |
| sign | true | String | 驗簽（驗簽拼接規則可自定義） |
**參數示例：**
~~~
{
"serverId":?"1",
"pid":?"1",
"sid":?"1",
"code":?"abcd123456",
"sign":?"338a7f911ee57b22836e71af426abdfd"
}
~~~
**返回字段：**
| **參數** | **必選** | **類型** | **說明** |
| --- | --- | --- | --- |
| code | true | int | 錯誤碼（發放成功碼必須位1000，其他可自定義） |
| message | true | String | 錯誤描述 |
**返回示例：**
~~~
{
"code":?1000,
"message":?"success"
}
~~~
