VIP业务接入文档
文档中所提的app_id、app_key需游戏提供并由客服人员填写在客服后台-权限设置-游戏列表中
一. VIP玩家总数接口
1.接口描述：根据客服后台传过去的vip等级，游戏方返回对应VIP等级及以上的所有VIP等级玩家信息（过滤不要内部号和某些渠道，具体渠道接入时沟通）
2.请求地址：游戏方提供
3.请求方式：GET/POST请求
4.URL请求参数
| 参数 | 备注 |
|---|---|
| app_id | 填在客服后台游戏列表中的app_id参数，作为接入客服后台的唯一标识 |
| t | 10位时间戳参数 |
| vip | vip等级参数 |
| sign | 根据上面的请求参数按字母升序排序，以&为连接符，拼接字符串，最后再拼接app_key的值获取加密原串，即app_id=%s&t=%s&vip=%s&%s，最后以md5加密方式加密原串获取sign参数 |
请求例子：接口一地址?app_id=ixx_kefu_youai_key&t=1629097868&vip=5&sign=***
5.返回参数：游戏方校验签名，签名通过后以json格式返回数据
| 参数 | 类型 | 备注 |
|---|---|---|
| code | int | 返回状态码，成功返回0，失败返回非0 |
| msg | str | 返回信息，成功返回success，失败返回失败原因 |
| data | list | 返回数据，失败返回空列表，成功则依次返回 服务器id、服务器名、角色id、角色名、vip等级、历史申请礼包、最后登陆时间 |
返回数据一般除了历史申请礼包没有则为空字符串，其余均不能为空，如果没有最后登陆时间，则过滤该玩家不传过来或者设置一个默认值 “1970-01-01 00:00:00”
返回例子：
{"code": 0, "msg": "success", "data": [[1601,"C647永无止境", 1678788533, "梨花落", 6, "VIP5认证奖励,VIP6认证奖励,VIP6生日祝福（梨容-梵净花枝）","2021-01-01 02:00:00"], [1601,"C647永无止境",1678781401, "白曦¤", 5, "","2021-01-01 02:00:00"], [1601,"C647永无止境", 1678788770, "白仙月", 6, "","2021-01-01 02:00:00"]]}二. VIP玩家详情接口
1.接口描述：根据客服后台传过去的角色ID，返回对应的所需数据
2.请求地址：游戏方提供
3.请求方式：GET/POST请求
4.URL请求参数
| 参数 | 备注 |
|---|---|
| app_id | 填在客服后台游戏列表中的app_id参数，作为接入客服后台的唯一标识 |
| t | 10位时间戳 |
| player_id | 角色id |
| server_id | 服务器id |
| sign | 根据上面的请求参数按字母升序排序，以&为连接符，拼接字符串，最后再拼接app_key的值获取加密原串，即app_id=%s&player_id=%s&server_id=%s&t=%s&%s，最后以md5加密方式加密原串获取sign参数 |
请求例子：接口二地址?app_id=ixx_kefu_youai_key&t=1629097868&player_id=2213549351&server_id=1234&sign=***
5.返回参数：游戏方校验签名，签名通过后以json格式返回数据
| 参数 | 类型 | 备注 |
|---|---|---|
| code | int | 返回状态码，成功返回0，失败返回非0 |
| msg | str | 返回信息，成功返回success，失败返回失败原因 |
| data | dict | 返回数据，失败返回空字典，成功看下图表格 |
| data参数 | ||
|---|---|---|
| 字段 | 类型 | 备注 |
| server | int | 服务器id，不可为空 |
| player_name | str | 角色名，没有该数据时为空字符串 |
| player_id | int | 角色id，不可为空 |
| vip_level | int | vip角色最新等级，不可为空 |
| create_time | datetime | 角色注册时间，不可为空，如”2023-06-16 16:30:00” |
| last_login_time | datetime | 最后登陆时间 ，不可为空，为空则接口一过滤掉不传该vip玩家过来或者设置默认值”1970-01-01 00:00:00” |
| last_pay_time | datetime | 最后充值时间 ，不可为空，为空则接口一过滤掉不传该vip玩家过来或者设置默认值”1970-01-01 00:00:00” |
| send_mail_time | datetime | 认证邮件申请时间，没有该数据时为空字符串 |
| read_mail_time | datetime | 认证邮件查阅时间，没有该数据时为空字符串 |
| send_birth_gift_time | datetime | 生日礼包申请时间，返回今年最近的一条数据，没有该数据时为空字符串 |
| accept_birth_gift_time | datetime | 生日礼包领取时间，返回今年最近的一条数据，没有该数据时为空字符串 |
| send_level_gift_time | datetime | 等级提升礼包申请时间，没有该数据时为空字符串 |
| accept_level_gift_time | datetime | 等级提升礼包领取时间，没有该数据时为空字符串 |
| send_recall_gift_time | datetime | 召回礼包申请时间，没有该数据时为空字符串 |
| accept_recall_gift_time | datetime | 召回礼包领取时间，没有该数据时为空字符串 |
| recall_login_time | datetime | 发送召回礼包后的首次登陆时间，没有该数据时为空字符串 |
| total_pay | int | 充值总金额 |
| daily_amount | int | 当日充值金额，根据传过去的时间戳参数，传回时间戳当日的充值金额，没有该数据时为空字符串 |
返回例子：
{'msg': 'success', 'code': 0, 'data': { 'player_name': '阳鹭汐', 'recall_login_time': '', 'send_birth_gift_time': '2021-06-18 14:14:35', 'send_recall_gift_time': '', 'send_mail_time': '2021-06-09 10:01:30', 'server': 2111, 'create_time':'2021-05-17 21:29:21', 'accept_birth_gift_time': '2021-06-18 20:11:14', 'read_mail_time': '2021-06-09 10:39:30', 'send_level_gift_time': '2021-06-10 17:43:16', 'vip_level': 5, 'player_id': 2213549351, 'last_pay_time': '2021-06-01 09:05:37', 'total_pay': 1062, 'accept_recall_gift_time': '', 'accept_level_gift_time': '2021-06-10 21:19:05', 'last_login_time': '2021-07-27 22:31:15', 'daily_amount': 1000}}三. 大额充值玩家接口
1.接口描述：根据客服后台传过去的日期，游戏方返回单笔充值648RMB及以上、单天累计充值满648RMB及以上的每一笔充值玩家数据
2.请求地址：游戏方提供
3.请求方式：GET/POST请求
4.URL请求参数
| 参数 | 备注 |
|---|---|
| app_id | 填在客服后台游戏列表中的app_id参数，作为接入客服后台的唯一标识 |
| t | 10位时间戳 |
| date | 日期参数，格式为yyyy-mm-dd，如2021-08-16 |
| sign | 根据上面的请求参数按字母升序排序，以&为连接符，拼接字符串，最后再拼接app_key的值获取加密原串，即app_id=%s&date=%s&t=%s&%s，最后以md5加密方式加密原串获取sign参数 |
请求例子：接口三地址?app_id=ixx_kefu_youai_key&t=1629097868&date=2021-08-16&sign=***
5.返回参数：游戏方校验签名，签名通过后以json格式返回数据
| 参数 | 类型 | 备注 |
|---|---|---|
| code | int | 返回状态码，成功返回0，失败返回非0 |
| msg | str | 返回信息，成功返回success，失败返回失败原因 |
| data | list | 返回数据，失败返回空列表，成功则依次返回 服务器id、角色id、vip等级、角色名、注册时间、充值时间、充值类型、充值金额 |
返回例子：
{"code":0,"msg":"success","data":[["3453","552831","11","\u8f6c\u8eab","2021-02-11 10:58:02","2021-08-22 00:05:03","\u6708\u5361","29"],["3453","552831","11","\u8f6c\u8eab","2021-02-11 10:58:02","2021-08-22 00:05:13","\u6708\u5361","29"],["3453","552831","11","\u8f6c\u8eab","2021-02-11 10:58:02","2021-08-22 00:05:21","\u5b63\u5ea6\u5361","59"],["3453","552831","11","\u8f6c\u8eab","2021-02-11 10:58:02","2021-08-22 00:06:01","\u5b63\u5ea6\u5361","59"]]}