游戏内容媒资接口文档更新时间:2024-10-17 11:26:00
概述
通用说明:接口调用必读
游戏内容媒资接口为全量和增量共用,采用合作方主动推送媒资信息的方式,需注意以下:
- 每次推送content数量不超过100条,超出请分多次推送
一、请求URL/Method
补充:将api_host替换成对应环境的域名
| HTTP URL | https://api_host/game/v1/push/general |
| HTTP Method | POST |
二、请求头
| 名称 | 类型 | 必填 | 描述 |
| Authorization | string | 是 | 示例值:"c83a2e753d41494fbde7b4aa31f4fa66" |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
三、请求体
| 字段名 | 字段类型 | 最大长度限制 | 是否必填 | 说明 |
| partnerId | string | 32 | 是 | 合作方id |
| timestamp | number | - | 是 | 当前请求时间戳,单位毫秒 |
| nonce | string | 32 | 是 | 随机值,相邻两次请求的nonce不允许重复,如果重复认为重复提交,响应失败 |
| contents | content[] | 100 | 是 | 游戏媒资列表 |
| 以下为content元素内容 | ||||
| id | string | 32 | 是 | 游戏唯一ID |
| name | string | 128 | 是 | 游戏名 |
| status | string | 1 | 是 | 上下线状态, "0":下线, "1":上线 |
| alias | string[] | 128 | 否 | 别名 |
| english_name | string | 128 | 否 | 英文名 |
| focus | string | 128 | 否 | 一句话介绍 |
| description | string | 512 | 是 | 简介 |
| type | string | 16 | 是 | 游戏类型 |
| operate_types | string[] | 16 | 是 | 操控方式,如["手柄", "遥控"] |
| tags | string[] | 16 | 是 | 标签 |
| year | number | - | 否 | 发行年份,如:2022 |
| pay_status | string | 1 | 是 | 付费状态:"0": 免费,"1": 收费,"2": 限免 |
| language | string[] | 16 | 否 | 语言,中文、粤语、英语、日语、韩语、法语、德语、西班牙语 |
| android_intent | string | 1024 | 是 | 跳转地址 |
| horizontal_poster | string | 1024 | 是 | 横版海报,1920x1080 |
| vertical_poster | string | 1024 | 是 | 竖版海报,552x316 |
| icon | string | 1024 | 是 | 游戏图标,长宽比1:1 |
| cp_rate | number | - | 否 | 评分,百分制;若合作方非百分制,需要用原始评分数值换算 |
| update_time | string | 19 | 是 | 更新时间,格式 yyyy-MM-dd HH:mm:ss |
| create_time | string | 19 | 是 | 创建时间,格式 yyyy-MM-dd HH:mm:ss |
| ext_info | string | 1024 | 否 | 拓展信息,可以是json字符串 |
四、响应参数
| 字段名 | 类型 | 最大长度 | 是否必填 | 说明 |
| code | String | - | 是 | 返回码 |
| msg | String | - | 是 | 返回码 |
五、示例
- 请求体示例:
{
"partnerId": "pi_xxx",
"timestamp": 1653281331000,
"nonce": "sfn1vjnjkmzedna",
"contents": [
{
"id": "10001",
"name": "xx跑酷",
"status": "1",
"alias": ["xx快跑"],
"english_name": "",
"focus": "xxxx",
"description": "xxxxxxxxxxxxxxxxxxxxxx",
"type": 1,
"operate_types": ["手柄", "遥控"],
"year": 2022,
"tags": ["射击", "动作"],
"pay_status": "2",
"language": ["中文", "英语"],
"android_intent": "",
"horizontal_poster": "https://xxx.com/1.jpg",
"vertical_poster": "https://xxx.com/2.jpg",
"icon": "https://xxx.com/3.jpg",
"cp_rate": 80,
"update_time": "2022-05-05 21:44:36",
"create_time": "2022-05-05 21:25:33",
"ext_info": "{}"
},
{
...
}
]
}- 响应体示例:
{
"code": "0000",
"msg": "success"
}六、补充说明
| 操控方式(operate_types) | 游戏类型(type) | 游戏标签(tags) |
| 遥控器 | 休闲益智 | 网游 |
| 虚拟手柄 | 消除 | 主机 |
| 手柄 | 体育 | 联机 |
| 键鼠 | 舞蹈 | 双人 |
| 体感 | 棋类 | 教育 |
| 跑酷 | 羽毛球 | |
| 牌类 | 乒乓球 | |
| 麻将 | 网球 | |
| 即时战略 | 足球 | |
| 建造 | 桌球 | |
| 合成 | 找茬 | |
| 格斗 | 换装 | |
| 捕鱼 | 弹珠 | |
| MOBA | 亲子 | |
| MMORPG | 篮球 | |
| 射击 | 记忆 | |
| 角色扮演 | 互动式电影 | |
| 桌游 | 创造 | |
| 竞速 | 吃鸡 | |
| 音游 | 视觉小说 | |
| 养成 | 生活 | |
| 模拟经营 | 球类 | |
| 战棋 | 平台游戏 | |
| 塔防 | 派对游戏 | |
| 赛车 | 农场 | |
| 经营 | 乐器 | |
| 解谜 | 俱乐部经营 | |
| 卡牌 | 节奏 | |
| 放置 | 驾驶 | |
| 动作 | 互动电影 | |
| 弹射游戏 | 花式竞技 | |
| 策略 | IO(大作战) | |
| 冒险 | 文字冒险 | |
| 飞行射击 | 图形冒险 | |
| 第一人称射击 | 自走棋 | |
| 第三人称射击 | 女性向 | |
| 开放世界 | ||
| 生存 | ||
| 沙盒 | ||
| 文字剧情 | ||
| 涂画 | ||
| 推理烧脑 | ||
| 逃生 | ||
| 数独 | ||
| 拼图 | ||
| 平台跳跃 | ||
| 迷宫解谜 | ||
| 连线 | ||
| 回合制战略 | ||
| JRPG | ||
| IO | ||
| GalGame | ||
| ARPG | ||
| 2D |
上一篇:音频内容API接入规范
文档内容是否有帮助?
有帮助
无帮助