OPPO开放平台API传包能力接入 资源分类对照表

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

能力介绍

通过接入API传包能力，您可以在内部系统实现一键发布应用、更新版本、更新资料、查询应用最新详情等，无需每次前往OPPO开放平台管理中心页面进行操作，能够节省人力，提高上架效率。
接入前建议您详细阅读帮助文档，按照流程和说明接入，如有疑问可以咨询在线客服。

注意：目前API传包能力面向普通应用、合作应用、合作游戏的开发者开放。

接入流程

API 调用方法详解

API调用是基于HTTP协议的。

调用流程：请求获取Access Token接口 -> 存储token（48小时有效） -> 拼接参数进行签名 -> 发起HTTP请求 -> 得到HTTP响应

调用注意事项：

所有的请求及响应数据编码均为utf-8格式；URL里的所有参数名和参数值都需进行URL编码。如果请求的Content-Type为application/x-www-form-urlencoded，则HTTP请求体里的所有参数值也做URL编码；如果是multipart/form-data格式，每个表单字段的参数值无需编码，但每个表单字段的charset部分需要指定为utf-8。

无特殊说明时，一般请求的 Content-type 为 application/x-www-form-urlencoded。

接口域名

正式环境：https://oop-openapi-cn.heytapmobi.com

获取Access Token

首先需要登录OPPO开放平台，获取客户端ID和密钥（若为团队帐号，需使用管理员帐号登录）。

具体路径：OPPO开放平台→管理中心→应用服务平台→API密钥管理→创建客户端→获取客户端ID、密钥。

调用业务接口前需先获取授权token (access token)，用于后续参数签名，开发者需要进行妥善保存。

Access token的有效期为48小时，超过有效期后需重新获取；在token过期前可重新调用接口获取新的access token（48小时有效），旧的access token将在5分钟内过期。

接口请求

-请求路由：/developer/v1/token
-请求方法：GET
-请求参数：

获取access token接口参数为：

通过发起HTTP Get请求，在URL中携带client_id与client_secret参数，可获取一次性access token。

• 接口响应：

{
    "errno": 0,
    "data": {
        "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MTU1MzE2NDYsInN1YiI6Ik9QUE8tT09QLU9QRU5BUEkiLCJuYmYiOjE2MTUzNTg4NDYsImF1ZCI6Im9wcG8tb29wIiwiaWF0IjoxNjE1MzU4ODQ2LCJqdGkiOiJ4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4Iiwic3RhdHVzIjoxLCJkYXRhIjp7ImNsaWVudF9pZCI6IjEqKioqKioqKioqKioqKioqKjAifX0.fNsW1gp7EIDRGw4-aHKCMJGIsRLO_FuR1BOcGAUwq7c",
        "expire_in": 1615531646
    }
}

• 响应说明：

公共参数

除获取授权token外，调用任何一个API都必须传入的参数：

签名方法

API签名计算规则为涉及的所有请求参数（包含get参数和POST参数，例如请求参数k1=v1,参数k2=v2）

step 1：请求参数（除api_sign外的公共参数+业务参数）按照ASCII升序排序

step 2：请求参数使用&拼接字符串，值为null的参数不参与签名，拼接成k1=v1&k2=v2

step 3：对step3得到的字符串进行HmacSHA256计算，计算时使用的密钥key为获取access token时与client_id配对的client_secret

step 4：将hash计算结果转换为小写16进制，得到签名sign。

签名代码示例：点击下载签名demo

OPPO开放平台边下边玩接入指引

什么是“边下边玩”

边下边玩是一种由OPPO软件商店提供的能力，它可以通过对软件包体进行分析，得到运行必要的模块与非必要模块。在用户安装的时候，会先传输必要的模块，当必要模块传输完成后，用户就可以启动应用进行使用，非必要模块会在用户使用的过程中逐块传输，以实现一边下载一边玩的能力。

如何接入“边下边玩”能力

“边下边玩”能力的功能完全由OPPO实现。作为开发者，您无需进行任何额外的开发，仅需提供一个V4签名即可（部分开发者无需提供，见下文）。

申请加入公测

当前边下边玩能力处于内测阶段，并未面向所有开发者和所有用户开放，如果您想要参与内测，请向我们提出申请。由于并非所有应用都会有良好的边下边玩表现（这与应用的实现方式密切相关），我们会选拔出表现相对较好的应用发布线上进行内测。

申请方式：
应用请发送邮件至：g_lyyunying@oppo.com，
游戏请发送邮件至：g_game_bd@oppo.com。
邮件正文如下：
1）应用名称：
2）应用包名：
3）应用ID：
4）开发者名称：
5）您是否愿意配合OPPO一起优化边下边玩功能：
6）您的应用（最新版本）是否符合以下条件：

如果您的应用符合以下条件，我们十分建议您申请开通能力，因为您的应用更有可能在边下边玩中表现的更好：

1）应用安装后不做大量资源解压缩（小于包体大小30%）；
2）应用安装后不做大量资源校验（小于包体大小30%）；
3）应用安装后不需要额外下载较大资源包；
4）应用拥有比较固定的使用流程（比如关卡游戏）。
5）如果应用是游戏，则单机游戏可能会拥有更好的体验。

这些并不是强制项，如果您的应用无法满足以上多个条件，但您依旧想使用边下边玩技术，您依然可以向我们发送申请，我们会进行评估，并与您持续沟通。

上传应用的V4签名

如果您的申请已通过，但没有上传入口，则说明您的应用无需上传签名即可拥有边下边玩能力。

当您的测试申请被批准后，在OPPO开放平台的应用资料更新页面就会出现V4签名的上传入口。

上传您的V4签名（点击查看如何给应用签V4签名），通过检验后提交即可。

当前有部分合作游戏无需上传V4签名，仅需加入内测名单即可，其他类型的应用则需要上传V4签名。

等待应用审核上架

当您的应用审核上架通过后，OPPO软件商店会对您的应用进行分析预测。分析结束后，用户在安装该应用的过程中就可以体验到边下边玩能力了。

“边下边玩”能力支持范围

终端软件商店版本：>= 9.0.75
终端Android版本：>= Android S
支持终端：目前仅支持手机

为什么我的应用“边下边玩”体验不佳？

这说明您的应用基础块依赖较多，用户需要下载较大比例才可以进入游戏。您可以尝试按照以下方向进行优化更新：
1）避免安装启动后的大量资源解压缩
2）避免安装包内置的资源digest校验
3）按需加载文件，规避首次启动后短时间内的大量文件使用

如果您有其他疑问，请联系我们。

为什么我开启了“边下边玩”，用户端却无法体验？

这可能是由于以下原因：
1）用户端未在设置中开启边下边玩能力。
2）您的应用包仍在分析分块中。
3）您的应用在边下边玩的系统测试中表现一般，未达到下发标准。
4）为了保证数据完整性和系统稳定性，我们只允许用户终端在同一时刻存在一个边下边玩应用。
5）用户的终端版本不符合要求或者未被选中为内测用户。

OPPO应用商店应用自更新赋能接入

背景

在目前的应用自更新场景中，大部分为应用先在后台下载新版本的APK，然后调用系统安装器进行安装，安装成功率较低，进而影响应用的版本升级成功率。

产品能力

OPPO软件商店目前应用自更新赋能，提供的能力点为：
a. 提供接口供申请方调用，用于获取其在OPPO软件商店上架的全量版本号。
b. 申请方在自升级场景下，可通过market协议拉起软件商店内全量的应用详情页，以此实现全量版本的升级。market协议格式为：market://details？id=应用包名&v_code = xxxx
c. 可申请跳转软件商店应用详情页后，在用户点击下载后跳转软件商店详情页即开始更新。

业务接入应用自更新赋能后的前端交互

a.合作方式一

应用内提示新版本更新，用户点击更新后跳转至OPPO软件商店内全量版本的应用详情页，立即开始更新。

b.合作方式二

应用提示新版本更新，点击更新后跳转至OPPO软件商店内全量版本的应用详情页，用户点击更新后开始下载并自动安装。

用户操作路径对比