2018-08-10

# API 文档

## 1.查询软件是否可激活

### 1.1 请求说明

> 请求方式：GET

请求URL ：https://openapi.insta360.com/app/pro2/softwareAuth

### 1.2 请求参数

字段      |字段类型      |字段说明

------------|-----------|-----------

serial      |string        |Pro2相机序列号

software_token      |string        |加密的软件标识（加密算法见文档底部说明）

### 1.3 返回结果

```json 

{

    "code": 0,

    "data": {

        "auth_enabled": true

    },

    "requestId": "79a201808101732231a4"

}

```

### 1.4 返回参数（data）

字段      |字段类型      |字段说明

------------|-----------|-----------

auth_enabled      |boolean        |是否允许激活软件

___

## 2.激活软件

### 2.1 请求说明

> 请求方式：POST

请求URL ：https://openapi.insta360.com/app/pro2/softwareAuth

### 2.2 请求参数（以json方式提交）

字段      |字段类型      |字段说明

------------|-----------|-----------

serial      |string        |Pro2相机序列号

software_token      |string        |加密的软件标识（加密算法见文档底部说明）

### 2.3 返回结果

```json 

{

    "code": 0,

    "data": {

        "success": true

    },

    "requestId": "79a201808101732231a4"

}

```

### 2.4 返回参数（data）

字段      |字段类型      |字段说明

------------|-----------|-----------

success      |boolean        |是否激活成功

___

## `#` 状态码说明（code）

状态码      |说明

------------|-----------

0      |请求成功

-1      |不合法的软件标识

3006      |不合法的相机序列号

## `#` 软件标识加密说明

    software_token = MD5(software_key + "-" + serial)

    例如：software_key = ABC，serial = test；

    则software_token = MD5("ABC-test")，即 218995277e8f57e460a7ffc3708fec19。