搜索
分发文档
应用分发
游戏分发
电视应用分发
快应用分发
快游戏分发
服务分发
内容分发
分发文档/内容分发/内容开放平台/开发对接/游戏内容媒资接口文档
游戏内容媒资接口文档更新时间: 2024-10-17 11:26:00

概述

通用说明:接口调用必读

游戏内容媒资接口为全量和增量共用,采用合作方主动推送媒资信息的方式,需注意以下:

  • 每次推送content数量不超过100条,超出请分多次推送

一、请求URL/Method

补充:将api_host替换成对应环境的域名
HTTP URLhttps://api_host/game/v1/push/general
HTTP MethodPOST

二、请求头

名称类型必填描述
Authorizationstring示例值:"c83a2e753d41494fbde7b4aa31f4fa66"
Content-Typestring固定值:"application/json; charset=utf-8"

三、请求体

字段名字段类型最大长度限制是否必填说明
partnerIdstring32合作方id
timestampnumber-当前请求时间戳,单位毫秒
noncestring32随机值,相邻两次请求的nonce不允许重复,如果重复认为重复提交,响应失败
contentscontent[]100游戏媒资列表
以下为content元素内容
idstring32游戏唯一ID
namestring128游戏名
statusstring1上下线状态, "0":下线, "1":上线
aliasstring[]128别名
english_namestring128英文名
focusstring128一句话介绍
descriptionstring512简介
typestring16游戏类型
operate_typesstring[]16操控方式,如["手柄", "遥控"]
tagsstring[]16标签
yearnumber-发行年份,如:2022
pay_statusstring1付费状态:"0": 免费,"1": 收费,"2": 限免
languagestring[]16语言,中文、粤语、英语、日语、韩语、法语、德语、西班牙语
android_intentstring1024跳转地址
horizontal_posterstring1024横版海报,1920x1080
vertical_posterstring1024竖版海报,552x316
iconstring1024游戏图标,长宽比1:1
cp_ratenumber-评分,百分制;若合作方非百分制,需要用原始评分数值换算
update_timestring19更新时间,格式 yyyy-MM-dd HH:mm:ss
create_timestring19创建时间,格式 yyyy-MM-dd HH:mm:ss
ext_infostring1024拓展信息,可以是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接入规范
文档内容是否有帮助?
有帮助
无帮助