游戏内容媒资接口文档更新时间: 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接入规范
文档内容是否有帮助?
有帮助
无帮助