一、概述

开放平台支持长视频、音频的规范接口调用，调用接口前，需了解如下内容：

• 接口概览：

• 接口调用流程：需申请相关权限、获取访问凭证，才能调用 API 。

二、申请相关权限

向小米申请 partnerId，partnerKey

• partnerId：小米分配的合作方唯一的标识符
• partnerKey：需要合作方高度保密，用于接口加密时拼装partnerKey作为加密串

三、获取访问凭证（access_token）

要访问小米内容推送API，需要先获取相应的访问凭证（access_token），作为API调用时的鉴权，在调用内容推送API时，小米可据此识别调用方的身份。通过此接口获取访问凭证，access_token具有一定的时效性，默认最长有效期为3600秒，在需要的情况下，合作方需要调用此接口来获取一个新的access_token。

补充说明：将api_host替换成合作方对应环境的域名

• 请求参数：

• 响应参数：

• 响应示例：

{ 
  "code": "0000", 
  "msg": "success", 
  "data": { 
    "access_token":"c83a2e753d41494fbde7b4aa31f4fa66", 
    "expires_in":"3600" 
  } 
}

四、 调用API

1、基本要求

• 完成获取partnerId，partnerKey
• 完成获取访问凭证
• 需要使用 HTTPS 协议、JSON 数据格式、UTF8 编码

2、请求参数说明

• 请求头：这部分参数需要放在 HTTP 请求的 Header 中，主要包含调用 API 所需要使用的访问凭证（access token）以及 HTTP Content-Type（除获取凭证外其余接口：Content-Type:application/json; charset=utf-8）
• 请求体：POST请求的请求参数以JSON格式放在请求body中
• 查询参数：这部分参数需要在URL后后使用?进行连接，多个查询参数间以&分隔

POST请求的sign参数放在请求URL中。如：https://api_host/api_path?sign=xxx'

3、API调用方式

调用API接口时，请求需要把访问凭证 access token 放到 Header 的 Authorization 中。 示例：

$ curl -X POST 'https://api_host/api_path?sign=xxx' 
-H 'Authorization:<这里替换为对应的access token>' 
-H 'content-type:application/json; charset=utf-8' 
-d '{ 
      "field": "value" 
    }'

4、API响应结果

API 的响应体结构包括 code、msg、data 三个部分。code为返回码，msg为返回信息，data为 API 的调用结果。默认请求成功时，code 为 0000，msg 为 success。data 在一些操作类 API 的返回中可能不存在

// 响应成功示例 
{ 
  "code": "0000", 
  "msg": "success" 
} 
 
{ 
  "code": "0000", 
  "msg": "success", 
  "data": { 
 // 响应的具体数据内容 
  } 
} 
 
// 响应失败示例 
{ 
  "code": "9991", 
  "msg": "invalid token" 
}

5、请求地址

6、返回码说明