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

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接口参数为：

参数名称	参数类型	是否必须	参数描述
client_id	string	是	OPPO开放平台申请分配的client_id，18位字符串
client_secret	string	是	OPPO开放平台申请分配的client_secret，与client_id配对，64位字符串

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

接口响应：

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

响应说明：

参数名称	参数类型	参数描述
access_token	string	返回的续期access token，48小时有效
expire_in	int	Unix时间戳，token将于此时过期

公共参数

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

参数名称	参数类型	是否必须	参数描述
access_token	string	是	鉴权接口返回的限期access_token
timestamp	string	是	时间戳（秒级）示例：1609401600，允许客户端请求最大时间误差为15分钟
api_sign	string	是	API输入参数签名结果，签名算法参照下面的介绍