OPPO开放平台API传包能力接入发布版本-APP开发

更新说明

更新时间	更新说明
2022-06-08	请求参数新增age_level、adaptive_equipment、adaptive_type、customer_contact；请求参数删除player_customer_email、player_customer_phone、player_customer_qq；请求参数summary不能多于13个字符

接口功能

此接口用于补充完善资源相关信息，会新增版本，为异步处理任务，可调用 获取任务状态 接口查询任务处理结果。

接口处理可能会比较耗时，建议客户端执行等待时间设置为10秒以上。

接口原型

-请求路由：/resource/v1/app/upd
-请求方法：POST
-请求类型：Content-Type: x-www-form-urlencoded

请求参数

参数名称	参数类型	是否必传	适用资源类型（无说明则都适用）	说明
pkg_name	string	必传		应用包名
version_code	string	必传		版本号
apk_url	ApkInfo[]	必传		apk 包信息，请求时需转换成json格式，CPU 多包传多个，结构参考 ApkInfo
app_name	string	必传		应用名称
app_subname	string	非必传	合作游戏	副标题，1-10 个字符，不得包含空格等特殊字符
second_category_id	int	必传		二级分类 ID，详情参照对照表
third_category_id	int	必传		三级分类 ID，详情参照对照表
summary	string	必传		一句话简介，不多于 13 个字符，不能包含任何标点符号和空格
detail_desc	string	必传		软件介绍，不少于 20 个字
update_desc	string	必传		版本说明，不少于 5 个字
privacy_source_url	string	必传		隐私政策网址
icon_url	string	必传		图标 url，尺寸：512*512px，图片格式：png，小于 1M
pic_url	string	必传		竖版截图 url，多个用英文逗号分隔，不能少于两张，上传 3-5 张截图，支持 jpg、png 格式。截图尺寸要求：1080*1920，单张图片不能超过 1M
landscape_pic_url	string	非必传		横版截图 url，多个用英文逗号分隔，上传 3-5 张截图，支持 jpg、png 格式。截图尺寸要求：1915*1080，单张图片不能超过 1M
video_url	string	非必传		游戏宣传视频地址，小于 30MB，支持格式：MP4
video_url_material	VideoInfo[]	非必传		视频扩展信息，请求时需转换成json格式，格式参考VideoInfo
online_type	int	必传		发布类型，1-审核立即发布；2-定时发布
sche_online_time	datetime	非必传		定时发布时间，online_type=2 时必填，不能早于当前时间
test_desc	string	必传		测试附加说明，最多输入 400 个字符
electronic_cert_url	string	非必传		电子版权证书，上传 PDF 格式文件，不能超过 20MB
copyright_url	string	必传	应用、合作应用	软件版权证明
icp_url	string	非必传	应用、合作应用	ICP 备案网址或备案号
special_url	string	非必传	应用、合作应用	特殊类证书，支持 jpg、png 格式的图片，每张图片大小不超过 1M
special_file_url	string	非必传	应用、合作应用	特殊类证书压缩包，支持 rar、zip 格式的文件，大小不能超过 30M
game_type	int	必传	合作游戏	游戏类型，1-单机；2-网游；3-棋牌；5-超休闲
video_pic_url	string	非必传	合作游戏	游戏宣传视频横屏封面图，尺寸：1080*594px，图片格式：jpg/png，小于 1M
cover_url	CoverURLInfo	必传	合作游戏	游戏空间封面图，请求时需转换成json格式，结构参考 CoverURLInfo
ascription_type	int	必传	合作游戏	游戏归属权，1-自研；2-代理
proxy_contract_url	string	必传	合作游戏	授权合同或协议/代理授权合同或协议 ascription_type=2 时必填，jpg/png 格式的图片，不超过 1M
authorize_type	int	必传	合作游戏	软件著作权登记类型，1-著作权证书
authorize_url	string	必传	合作游戏	软件著作权登记证，jpg/png 格式的图片，不超过 1M
authorize_desc	string	必传	合作游戏	软件著作权登记号
approval_doc_number	string	必传	合作游戏	游戏版号编号
approval_doc_type	int	必传	合作游戏	版号有效期类型，1-永久有效；2-固定游戏期
approval_doc_start_time	datetime	必传	合作游戏	版号有效期开始时间，approval_doc_type=2 时必填
approval_doc_end_time	datetime	必传	合作游戏	版号有效期结束时间，approval_doc_type=2 时必填
approval_doc_url	string	必传	合作游戏	游戏版号证书，jpg/png 格式的图片，不超过 1M
record_identification_code	string	非必传	合作游戏	备案识别码，有版号时必填，10 位数字
record_identification_image	string	非必传	合作游戏	渠道绑定截图，有版号时必填，jpg/png 格式的图片，大小不超过 1M
culture_record_number	string	非必传	合作游戏	文化部备案文件编号
culture_record_url	string	非必传	合作游戏	文化部备案文件，jpg/png 格式的图片，不超过 1M
operation_license_url	string	非必传	合作游戏	网络文化经营许可证，jpg/png 格式的图片，不超过 1M
absolve_declare_url	string	非必传	合作游戏	免责声明，jpg/png 格式的图片，不超过 1M
other_cetificate_url	string	非必传	合作游戏	其他补充资质，支持 zip 格式，大小不超过 30M
business_username	string	必传		商务联系人姓名
business_email	email	必传		商务联系人邮箱
business_mobile	string	必传		商务联系人电话
business_qq	string	非必传	合作游戏	商务联系人 QQ
business_position	string	非必传	合作游戏	商务联系人职务
business_address	string	非必传	合作游戏	商务联系人办公地址
age_level	int	必传	普通应用、合作应用、合作游戏	APP年龄分级，示例：3
adaptive_equipment	int	必传	普通应用、合作应用、合作游戏	平板适配，4-手机，5-平板，6-手机和平板
adaptive_type	int	非必传	普通应用、合作应用、合作游戏	适配方式，1-平行视窗，2-横竖屏自适应适配
customer_contact	string,json字符串	必传	合作游戏	客服联系方式，示例： [{“contact_method”:“7”,“contact_info”:“点击客服头像Kate”,“working_hours”:“00:01-00:07”,“weekend_hours”:“00:23-01:14”}]， contact_method：联系方式，1-客服电话，2-客服邮箱，3-客服QQ号，4-客服QQ公众号，5-客服微信号，6-客服微信公众号，7-游戏内联系客服路径 contact_info：客服联系信息 working_hours：工作服务时间 weekend_hours：周末&节假日服务时间

ApkInfo

字段	类型	说明
url	string	apk 包地址
md5	string	apk 包 md5 值
cpu_code	int	多包平台，64 位 CPU 包为 64，32 位 CPU 包为 32，非多包应用为 0

VideoInfo

-可从文件上传接口获取

字段	类型	说明
url	string	视频地址
md5	string	视频MD5值
size	int	视频文件大小
width	int	视频尺寸：宽
height	int	视频尺寸：高
fps	int	视频帧率
duration	int	视频时长
definition	int	视频码率

CoverURLInfo

字段	类型	说明
h	map	横版封面，包含一个图片 url 字段，尺寸：939*507px，图片格式：JPG/PNG，小于 1M
v	map	竖版封面，包含一个图片 url 字段，尺寸：756*1080px，图片格式：JPG/PNG，小于 1M

结构示例：

{
    "v":{
        "url":"http://******4494fa0b.jpg"
    },
    "h":{
        "url":"http://******80b90afc.jpg"
    }
}

请求响应

响应说明

字段	类型	说明
errno	int	错误码，为 0 表示请求正常
data	UpdBody	响应体，结构参考 UpdBody

UpdBody

字段	类型	说明
success	boolen	请求成功时返回，必为 true
message	string	响应信息，请求失败时会返回错误信息说明
logid	int	请求ID

响应示例

成功示例

{
    "errno":0,
    "data":{
        "success":true,
        "message":""
    }
}

失败示例

{
    "errno":800002,
    "data":{
        "message":"包名不能为空",
        "logid":3906849174
    }
}

编辑：yimen，如若转载，请注明出处：https://www.yimenapp.com/kb-yimen/10827/

部分内容来自网络投稿，如有侵权联系立删

OPPO开放平台API传包能力接入 发布版本