# 自动发放礼包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"
}
~~~
