站点内容接口
站点配置
获取商户运营配置的轮播图、弹窗、悬浮框等位图资源,由后台「站点内容/配置」维护。无需登录。
URL: GET /site_content/config
Query: 无
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| data | object | 站点配置对象,结构见下表 |
data 字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| main_banners | list<object> | 主轮播图资源列表,元素结构见下表 |
| middle_banners | list<object> | 中部轮播图资源列表 |
| bonus_banners | list<object> | 奖金页轮播图资源列表 |
| popups | list<object> | 弹窗资源列表 |
| floating_lefts | list<object> | 左侧悬浮框资源列表 |
| floating_rights | list<object> | 右侧悬浮框资源列表 |
| service_links | list<object> | 客服链接列表,元素结构见下方专表 |
| social_manage | list<object> | 社媒管理列表,元素结构见下方专表 |
| game_tag_ids | list<string> | 首页标签区块的游戏标签 ID 列表,已按摆放顺序排列,说明见下方专节 |
| lobby_game_tag_ids | list<string> | 游戏大厅标签区块的游戏标签 ID 列表,语义与 game_tag_ids 一致 |
| vip_service_link | string | VIP 贵宾客服链接,未配置为空字符串 |
| vip_channel_link | string | VIP 频道链接,未配置为空字符串 |
| message_community_link | string | 站内信社区链接,未配置为空字符串 |
资源元素字段(前 5 个列表通用):
| 字段 | 类型 | 说明 |
|---|---|---|
| title | string | 标题(无障碍提示 / 备注用) |
| image_url | string | 图片地址 |
| url | string | 跳转地址,站内 /foo 或外链 https:// |
| sort_order | int | 排序,升序 |
| is_active | bool | 是否启用 |
service_links 元素字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| link_type | int | 客服类型:1=在线客服 / 2=Whatsapp / 3=Telegram |
| link | string | 目标链接(URL 或 IM 账号) |
| sort_order | int | 排序,升序 |
| is_active | bool | 是否启用 |
social_manage 元素字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| link_type | int | 链接类型,固定 1=外部链接 |
| location | int | 展示位置:1=左菜单栏底部 / 2=兑换码 |
| icon | string | 图标 URL |
| link | string | 跳转链接 |
| sort_order | int | 排序,升序 |
| is_active | bool | 是否启用 |
social_manage同一列表混合多个location,前端需按location自行分组展示。
game_tag_ids / lobby_game_tag_ids 说明:
两个字段均为标签 ID 字符串数组(仅 ID,不含标签内容),由商户在后台「站点内容配置 - 标签区块」分别独立挑选与排序,同一标签可同时出现在两组,均可能为空数组。数组顺序 = 后台对应区块的摆放顺序,即前端的渲染顺序。
前端拿到 ID 后,把整个数组逗号拼接一次调用【标签详情(含游戏)】获取标签名称与嵌套在架游戏后按返回顺序渲染区块;已删除 / 停用的标签 ID(配置中可能残留)会被服务端静默跳过,无需前端处理。
popups 的活动弹窗(自动注入):
| 字段 | 类型 | 说明 |
|---|---|---|
| kind | string | 活动类型,如 recharge_bonanza;daily_bankrupt_pack 见每日幸运补偿,lucky_compensation 见幸运补偿(仅待开箱态下发,其余字段同其 Offer 对象) |
可选头像列表
商户在后台「站点内容/头像配置」维护的预设头像,仅返回启用中的项,按 sort_order 升序。无需登录。
注册时若商户配置了至少一张启用中的头像,服务端会随机分配一张写入会员的
head_portrait(见【User 对象】);未配置则head_portrait为空,由客户端展示默认头像。
URL: GET /site_content/avatars
Query: 无
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| list | list<object> | 头像列表,元素结构见下表 |
元素字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 名称(可能为空) |
| image_url | string | 图片地址,也是【选择头像】的入参 |
| sort_order | int | 排序,升序 |
| is_active | bool | 是否启用,本接口恒为 true |
选择头像
从【可选头像列表】中选一张作为自己的头像,成功后会员 head_portrait 即为该 image_url。需登录。
与【修改用户资料】直接传
head_portraitURL 的区别:本接口服务端校验所选图片必须在启用中的预设列表内,已停用 / 删除的头像返回错误头像不存在或已停用。
URL: POST /site_content/avatar/select
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image_url | string | 是 | 头像图片地址,取自列表元素的 image_url |
输出: 无