标签归档：OPPO接口

OPPO开放平台API传包能力接入 查询多包应用详情

发表于由

查询多包应用详情

更新说明

更新时间更新说明
2022-06-08请求响应新增age_level、adaptive_equipment、adaptive_type、customer_contact

接口功能

此接口用于查询多包应用详情信息。

接口原型

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

请求参数

参数类型必传说明
pkg_namestring必传应用包名

请求响应

响应说明

参数类型说明
errnoint错误码，为0表示成功
dataMultiDetailInfo多包应用详情，结构参考MultiDetailInfo

MultiDetailInfo

字段类型说明
app_idstring应用ID
pkg_namestring应用包名
typeint应用类型
signstring应用包签名
dev_idstring开发者ID
app_keystring游戏支付key(公钥)
update_timestring应用更新时间
app_create_timestring应用创建时间
app_namestring应用名称
is_freezestring是否冻结，0-否；1-是
freeze_reasonstring[]冻结原因
refuse_reasonstring打回原因
tag_liststring游戏标签
is_businessstring是否合作，0-否；1-是
game_typestring游戏类型
second_category_idstring二级分类
third_category_idstring三级分类
copyright_urlstring软件版权证明
special_urlstring特殊类证书
special_file_urlstring特殊类证书压缩包
freeze_filestring冻结附件
business_usernamestring商务联系人姓名
business_emailstring商务联系人邮箱
business_mobilestring商务联系人电话
business_qqstring商务联系人QQ
business_positionstring商务联系人职务
business_addressstring商务联系人办公地址
freeze_advicestring冻结建议
app_typestringapp类型，0-未设置；1-合作应用
app_real_typestringapp类型，0-非合作状态，1-合作状态
electronic_cert_urlstring电子版权证书
icp_urlstringICP备案网址或备案号
apk_infomap<String, ApkVersionInfo>应用多包信息，key为版本号，值字段参考ApkVersionInfo
pkg_symbolint包类型，1-cpu多包；2-多签名多包
second_category_namestring二级分类名称
third_category_namestring三级分类名称
transfer_stateint转让状态，-1-无；1-审核通过；2-审核不通过；3-同意接受；4-不同意接受
last_version_namestring最新版本名称
same_version_statusint同版本更新申请状态，0-未使用；1-已使用
age_levelstringAPP年龄分级，示例：3
adaptive_equipmentstring平板适配，4-手机，5-平板，6-手机和平板
adaptive_typestring适配方式，1-平行视窗，2-横竖屏自适应适配

ApkVersionInfo

字段类型说明
version_idstring版本ID
app_idstring应用ID
version_codestring版本号
version_namestring版本名称
apk_urlstringapk链接
apk_sizestringapk包大小
apk_md5stringapk包MD5
header_md5stringapk头部MD5
package_permissionstring[]包权限
package_permission_descstring包权限描述
resolutionstring分辨率
version_typestring版本类型，1-新增；2-更新；3-更新资料
create_timestring版本创建时间
cpu_codestringcpu类型
apk_full_urlstringapk包完整链接
sign_descstring多签名类型描述
signstring包签名
online_typestring发布类型1-审核立即发布2-定时发布
sche_online_timestring定时发布时间
test_typestring测试类型
test_start_timestring游戏内测开始时间
test_end_timestring游戏内测结束时间
player_customer_emailstring玩家客服游戏
player_customer_phonestring玩家客服电话
player_customer_qqstring玩家客服QQ
is_signaturestring是否签名，0-否；1-是
is_pre_downloadstring是否开启预下载，1-否；2-是
app_namestring应用名称
icon_urlstring图标url
icon_md5string图标md5
summarystring一句话简介
detail_descstring软件介绍
update_descstring版本说明
app_subnamestring副标题
test_descstring测试附加说明
video_urlstring视频地址
pic_urlstring竖屏截图地址
video_pic_urlstring游戏宣传视频横屏封面图
cover_urlstring游戏空间封面图
landscape_pic_urlstring横屏截图地址
privacy_source_urlstring隐私政策网址
levelstring等级，-1-D；0-C；1-B；2-A
statestring上架状态，1-上架；2-下架
online_timestring上架时间
offline_timestring下架时间
business_refuse_reasonstring商务审核打回理由
update_timestring更新时间
audit_status_namestring审核状态
offline_infostring下架信息
update_info_checknumber更新资料审核状态，1-审核中；0-不在审核中
level_tagstring等级标签
refuse_advicestring打回建议
refuse_reasonstring打回理由
refuse_filestring打回附件
pic_url_materialPicMaterialinfo[]竖版截图扩展信息，详情参考PicMaterialinfo

PicMaterialinfo

字段类型说明
urlstring图片地址
widthstring图片宽
heightstring图片高
md5string图片md5
sizestring图片大小

响应示例

成功示例

{
    "errno": 0,
    "data": {
        "app_id": "111",
        "pkg_name": "com.foo.bar.nearme.gamecenter",
        "type": 10,
        "sign": "23f1****e6cd",
        "dev_id": "11111",
        "app_secret": "909c****36a3",
        "server_secret": "132c****b858",
        "app_key": "5125****2ea5",
        "update_time": "2021-06-10 18:33:08",
        "app_create_time": "2021-06-10 17:38:52",
        "app_name": "xxxxx",
        "is_freeze": "0",
        "freeze_reason": [
            [
                null,
                null
            ]
        ],
        "refuse_reason": "",
        "tag_list": null,
        "is_business": "0",
        "game_type": "0",
        "second_category_id": "77",
        "third_category_id": "6689",
        "copyright_url": "http://******9fda50.jpg,,",
        "special_url": "",
        "special_file_url": "",
        "freeze_file": null,
        "business_username": "商务联系人姓名",
        "business_email": "44****@qq.com",
        "business_mobile": "13*******41",
        "business_qq": "",
        "business_position": "",
        "business_address": "",
        "freeze_advice": null,
        "app_type": "1",
        "app_real_type": "1",
        "ad_type": "0",
        "dev_name": "",
        "electronic_cert_url": "",
        "icp_url": "xxxxx",
        "refuse_advice": "",
        "state": "11",
        "apk_info": {
            "11111111": {
                "version_id": "11111111",
                "app_id": "111",
                "version_code": "1",
                "version_name": "1.0",
                "apk_url": "/******cbad.apk",
                "apk_size": "1.89 MB",
                "apk_md5": "f565****811e",
                "header_md5": "01b0****b816",
                "channel": "0",
                "package_permission": [
                    "android.permission.ACCESS_COARSE_LOCATION",
                    "android.permission.READ_CALENDAR",
                    "android.permission.READ_CALL_LOGS",
                    "android.permission.WRITE_CONTACTS",
                    "android.permission.WRITE_CAMERA",
                    "android.permission.CALL_PHONE"
                ],
                "package_permission_desc": null,
                "resolution": null,
                "version_type": "1",
                "create_time": "2021-06-10 18:33:08",
                "min_sdk_version": "16",
                "target_sdk_version": "29",
                "cpu_code": "32",
                "release_type": "1",
                "apk_full_url": "http://******16cbad.apk",
                "sign_desc": "A",
                "sign": "366d****f571,366d****f571",
                "online_type": "1",
                "sche_online_time": null,
                "test_type": "0",
                "test_start_time": "0000-00-00 00:00:00",
                "test_end_time": "0000-00-00 00:00:00",
                "player_customer_email": null,
                "player_customer_phone": null,
                "player_customer_qq": "",
                "is_signature": "0",
                "is_pre_download": "1",
                "app_name": "ceshi0007",
                "lang": "zh",
                "icon_url": "http://******7b633.jpg",
                "icon_md5": "",
                "summary": "xxxxxxxxxx",
                "detail_desc": "xxxxxxxxxx",
                "update_desc": "xxxxxxxxxx",
                "app_subname": "",
                "test_desc": null,
                "video_url": "",
                "pic_url": "http://******7983c2.jpg,http://******a6234f.jpg,http://******bdabfe.jpg",
                "video_pic_url": null,
                "cover_url": null,
                "landscape_pic_url": "",
                "privacy_source_url": "http://foo.bar.com",
                "release_desc": "",
                "region": "CN",
                "level": "1",
                "state": "1",
                "audit_status": "111",
                "online_time": "2021-06-11 11:40:40",
                "offline_time": "2021-06-11 09:07:10",
                "is_first_publish": "0",
                "business_refuse_reason": "a:1:{i:0;s:1:\"1\";}",
                "release_status": "0",
                "update_time": "2021年06月10日 18:33:08",
                "audit_status_name": "上线",
                "offline_info": null,
                "update_info_check": 0,
                "level_tag": "B",
                "refuse_advice": "",
                "refuse_reason": "1",
                "refuse_file": "",
                "permission_list": [
                    [
                        "android.permission.ACCESS_COARSE_LOCATION",
                        "获取WIFI定位",
                        ""
                    ],
                    [
                        "android.permission.READ_CALENDAR",
                        "读取日历",
                        ""
                    ],
                    [
                        "android.permission.WRITE_CONTACTS",
                        "修改删除联系人",
                        ""
                    ],
                    [
                        "android.permission.WRITE_CAMERA",
                        "使用摄像头",
                        ""
                    ],
                    [
                        "android.permission.CALL_PHONE",
                        "拨打电话",
                        ""
                    ]
                ],
                "pic_url_material": [
                    {
                        "url": "http://******7983c2.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    },
                    {
                        "url": "http://******a6234f.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    },
                    {
                        "url": "http://******bdabfe.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    }
                ]
            },
            "11111112": {
                "version_id": "11111112",
                "app_id": "12024352",
                "version_code": "1",
                "version_name": "1.0",
                "apk_url": "/apk/****6d80.apk",
                "apk_size": "1.9 MB",
                "apk_md5": "564a****6ad4",
                "header_md5": "01b0****b816",
                "channel": "0",
                "package_permission": [
                    "android.permission.ACCESS_COARSE_LOCATION",
                    "android.permission.READ_CALENDAR",
                    "android.permission.READ_CALL_LOGS",
                    "android.permission.WRITE_CONTACTS",
                    "android.permission.WRITE_CAMERA",
                    "android.permission.CALL_PHONE"
                ],
                "package_permission_desc": null,
                "resolution": null,
                "version_type": "1",
                "create_time": "2021-06-10 18:33:08",
                "min_sdk_version": "16",
                "target_sdk_version": "29",
                "cpu_code": "64",
                "sign_v1": "366d****f571",
                "sign_v2": "366d****f571",
                "sign_v3": "",
                "release_type": "1",
                "apk_full_url": "http://******/apk/202106/10/****6d80.apk",
                "sign_desc": "A",
                "sign": "366d****f571,366dc****f571",
                "online_type": "1",
                "sche_online_time": null,
                "test_type": "0",
                "test_start_time": "0000-00-00 00:00:00",
                "test_end_time": "0000-00-00 00:00:00",
                "player_customer_email": null,
                "player_customer_phone": null,
                "player_customer_qq": "",
                "is_signature": "0",
                "is_pre_download": "1",
                "app_name": "ceshi0007",
                "lang": "zh",
                "icon_url": "http://******37b633.jpg",
                "icon_md5": "",
                "summary": "xxxxxxxxxx",
                "detail_desc": "xxxxxxxxxx",
                "update_desc": "xxxxxxxxxx",
                "app_subname": "",
                "test_desc": null,
                "video_url": "",
                "pic_url": "http://******7983c2.jpg,http://******a6234f.jpg,http://******bdabfe.jpg",
                "video_pic_url": null,
                "cover_url": null,
                "landscape_pic_url": "",
                "privacy_source_url": "http://foo.bar.com",
                "release_desc": "",
                "region": "CN",
                "level": "1",
                "state": "2",
                "audit_status": "222",
                "online_time": "2021-06-11 09:06:28",
                "offline_time": "2021-06-11 11:36:31",
                "is_first_publish": "0",
                "business_refuse_reason": "a:1:{i:0;s:1:\"1\";}",
                "release_status": "0",
                "update_time": "2021年06月10日 18:33:08",
                "audit_status_name": "下线",
                "update_info_check": 0,
                "level_tag": "B",
                "refuse_advice": "",
                "refuse_reason": "1",
                "refuse_file": "",
                "permission_list": [
                    [
                        "android.permission.ACCESS_COARSE_LOCATION",
                        "获取WIFI定位",
                        ""
                    ],
                    [
                        "android.permission.READ_CALENDAR",
                        "读取日历",
                        ""
                    ],
                    [
                        "android.permission.WRITE_CONTACTS",
                        "修改删除联系人",
                        ""
                    ],
                    [
                        "android.permission.WRITE_CAMERA",
                        "使用摄像头",
                        ""
                    ],
                    [
                        "android.permission.CALL_PHONE",
                        "拨打电话",
                        ""
                    ]
                ],
                "pic_url_material": [
                    {
                        "url": "http://******7983c2.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    },
                    {
                        "url": "http://******a6234f.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    },
                    {
                        "url": "http://******bdabfe.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    }
                ]
            }
        },
        "pkg_symbol": 1,
        "second_category_name": "便捷生活",
        "third_category_name": "美食外卖",
        "transfer_state": -1,
        "show_active": null,
        "last_version_name": "1.0",
        "same_version_status": 0,
        "first_publish": 0,
        "is_has_reserve": 0,
        "reserve_state": 2,
        "age_level": "3",
        "adaptive_equipment": "4",
        "adaptive_type": "1"
    }
}

失败示例

{
    "errno": 911045,
    "data": {
        "message": "开发者ID和包名不匹配",
        "logid": 2204318265
    }
}

OPPO开放平台API传包能力接入 文件上传

发表于由

OPPO开放平台API传包能力接入 文件上传

上传流程说明

1）请求 获取上传配置 接口实时获取上传的请求 URL 和 sign。

2）请求 upload_url，参数为 文件上传 接口列出的参数，sign 是一次性的，每上传一个文件都需要重新获取一次。

获取上传配置

接口功能

此接口用于获取上传文件配置。

接口原型

-请求路由：/resource/v1/upload/get-upload-url
-请求方法：GET
-请求类型：Content-Type: x-www-form-urlencoded

请求参数

只需传入公共参数。

请求响应

响应说明

字段类型说明
errnoint错误码，为 0 表示请求成功
dataPreUploadBody响应结果，结构参考 PreUploadBody

PreUploadBody

字段类型说明
upload_urlstring文件上传 URL
signstring一次性标识，单次有效，每个新文件必须重新获取

响应示例

成功示例
{
    "errno": 0,
    "data": {
        "upload_url": "https://oppo.com/xxxxxxxxx",
        "sign": "b1fe****ad13"
    }
}

文件上传

接口功能

此接口用于上传文件。

接口原型

  • 请求 URL：接口获取上传配置返回的 upload_url
  • 请求方法：POST
  • 请求类型：Content-Type: multipart/form-data

请求参数

字段类型是否必传说明
typestring是文件类型，包括照片、APK 包、其它，值是：photo、apk、resource
signstring是一次性标识，从获取上传配置返回的 sign 字段，单次有效，每个新文件必须重新获取
filebinary是文件对象

请求响应

响应说明

字段类型说明
errnoint错误码，为 0 表示请求成功
datamap响应结果，参考 UploadObj

UploadObj

字段类型说明
urlstring文件地址（带域名）
uri_pathstring文件 URI（不带域名）
md5string文件 MD5
file_extensionstring文件扩展名
file_sizeint文件大小
idstring标记
widthint图片宽度（只有图片才有）
heightint图片高度（只有图片才有）

响应示例

成功示例

APK 类型
{
    "errno": 0,
    "data": {
        "url": "https://oppo.com/********261d.apk",
        "uri_path": "/********261d.apk",
        "md5": "5efd****4d4d",
        "file_extension": "apk",
        "file_size": 4181241,
        "id": "XXXXX"
    }
}
图片类型
 {
     "errno": 0,
     "data": {
         "url": "http://oppo.com/********d47d.jpg",
         "uri_path": "/********d47d.jpg",
         "md5": "55e3****1084",
         "sign": "eee4****bce4",
         "width": 1080,
         "height": 1920,
         "file_extension": "jpg",
         "file_size": 598879
     }
 }
resource
{
    "errno": 0,
    "data": {
        "url": "http://oppo.com/********a936.pdf",
        "uri_path": "/********a936.pdf",
        "md5": "d557****4931",
        "sign": "b384****821f",
        "file_extension": "pdf",
        "file_size": 15106
    }
}

失败示例

-sign 过期或不合法，需要重新调用接口获取 sign

{
    "errno": 910003,
    "data": {
        "message": "Unauthorized upload [1]",
        "logid": 2965369111,
        "ext": []
    }
}

OPPO开放平台API传包能力接入 多包资料更新

发表于由

多包资料更新

更新说明

更新时间更新说明
2022-06-08请求参数summary不能多于13个字符

接口功能

此接口用于多包应用资料更新。

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

接口原型

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

请求参数

参数名称参数类型是否必传备注
pkg_namestring必传包名
version_codestring必传版本号
summarystring必传一句话简介，不多于 13 个字符，不能包含任何标点符号和空格
detail_descstring必传软件介绍，不少于 20 个字
update_descstring必传版本说明，不少于 5 个字
privacy_source_urlstring必传隐私政策网址
icon_urlstring必传图标 url，尺寸：512*512px，图片格式：png，小于 1M
pic_urlstring必传竖版截图 url，多个用英文逗号分隔，不能少于两张，上传 3-5 张截图，支持 jpg、png 格式。 截图尺寸要求：1080*1920，单张图片不能超过 1M
landscape_pic_urlstring非必传横版截图 url，多个用英文逗号分隔，上传 3-5 张截图，支持 jpg、png 格式。 截图尺寸要求：1915*1080，单张图片不能超过 1M
video_urlstring非必传游戏宣传视频地址，小于 30MB，支持格式：MP4
video_url_materialVideoInfo[]非必传视频扩展信息，请求时需转换成json格式，格式参考VideoInfo
test_descstring必传测试附加说明，最多输入 400 个字符
electronic_cert_urlstring非必传电子版权证书，上传 PDF 格式文件，不能超过 20MB
copyright_urlstring必传软件版权证明
icp_urlstring非必传ICP 备案网址或备案号
special_urlstring非必传特殊类证书，支持 jpg、png 格式的图片，每张图片大小不超过 1M
special_file_urlstring非必传特殊类证书压缩包，支持 rar、zip 格式的文件，大小不能超过 30M
business_usernamestring必传商务联系人姓名
business_emailemail必传商务联系人邮箱
business_mobilestring必传商务联系人电话

VideoInfo

  • 可从文件上传接口中获取
字段类型说明
urlstring视频地址
md5string视频MD5值
sizeint视频文件大小
widthint视频尺寸：宽
heightint视频尺寸：高
fpsint视频帧率
durationint视频时长
definitionint视频码率

请求响应

响应说明

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

UpdBody

字段类型说明
successboolen请求成功时返回，必为 true
messagestring响应信息，请求失败时会返回错误信息说明
logidint请求ID

响应示例

成功示例

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

失败示例

{
    "errno":911219,
    "data":{
        "message":"游戏暂不支持 CPU 多包",
        "logid":4218474084
    }
}