5. 具体业务接口

5.1. 签名计算

Note

调用服务端业务接口时，除业务需要的参数外，另需四个固定参数加入到每次的调用中，包含token(获得的accessToken值)、time(时间戳，秒)、v(版本号)、sign(通过计算得到的签名)。

Note

计算sign的方法：除sign字段外，对所有参数进行首字母排序，之后到的值使用key1=value1&key2=value2的形式连接起来，最后形成的数据为： tmp = A=ValueA&B=ValueB&C=ValueC，再把接口地址和tmp以及固定盐拼接起来进行md5，得到的大写结果作为sign的值。

使用示例：

固定盐(newSalt)：GwT/+ZNeRHwPQ
接口(newUrl )：接口地址（如：/v3/openapi/live/getLiveBaseInfo）
参数(newParams)：去掉sign参数外所有参数按照ABCD自然排序后,newParams = key1=value1&key2=value2...
签名(sign)：sign = md5(newUrl + newParams + newSalt);("+"代表连接符)

举例：
固定盐(newSalt)：GwT/+ZNeRHwPQ
接口(newUrl )：/v3/openapi/live/getLiveBaseInfo
参数(newParams)：access_token=930f862b8f1e42923433f661fecd5e19&client_id=220110214328&psn=ZTU3VSA2005XJKWG&time=1641954173&v=9-1-1.0.1-1-0
签名(sign)：sign = md5(/v3/openapi/live/getLiveBaseInfoaccess_token=930f862b8f1e42923433f661fecd5e19&client_id=220110214328&psn=ZTU3VSA2005XJKWG&time=1641954173&v=9-1-1.0.1-1-0GwT/+ZNeRHwPQ);
得到结果转为大写：EA2556F06DB4A5CDCB70A443FE048ED5

5.2. 直播数据接口

5.2.1. 基础信息接口

功能：获取直播基础信息

调用：v3/openapi/live/getLiveBaseInfo

请求类型：post

请求参数：

参数	必选	类型	默认值	说明
time	是	string		时间戳(秒)
v	是	string	9-1-1.0.1-1-0	版本号（固定值）
sign	是	string		签名
access_token	是	string		获取的AccessToken
psn	是	string		飞机sn
client_id	是	string		分配的client_id

返回示例：
{
"status": 1,
"tips": "操作成功",
"data": {
    "planeSn": "ZTU3VSA2007JVNMT",
    "userName": "张三",
    "address": "中国",
    "liveStatus": 1,
    "m3u8Address": "https://yxapi.tusuav.com/202111021203236805.m3u8"
    }
}

返回说明：

参数名	类型	说明
status	string	无
tips	string	无
data	array	无
planeSn	string	整机sn
userName	string	使用人
address	string	位置
liveStatus	string	直播状态 1-直播中
m3u8Address	string	m3u8地址

5.2.2. 飞行状态数据接口

功能：获取飞行状态相关数据

调用：v3/openapi/live/getFlyDetailInfo（调用频率1~2秒/次左右）

请求类型：post

请求参数：

参数	必选	类型	默认值	说明
time	是	string		时间戳(秒)
v	是	string	9-1-1.0.1-1-0	版本号（固定值）
sign	是	string		签名
access_token	是	string		获取的AccessToken
psn	是	string		飞机sn
client_id	是	string		分配的client_id

返回示例：
{
"status": 1,
"tips": "操作成功",
"data": {
    "planeSn": "ZTU3VSA2007JVNMT",
    "ft": 128,
    "lon": "114.2847748",
    "lat": "35.0489883",
    "th": "182",
    "ksd": "66.00",
    "dsd": "69.92",
    "dl": "0",
    "dy": "24.05",
    "gxs": "9",
    "dx": "OK",
    "y": "82"
    }
}

返回说明：

参数名	类型	说明
status	string	无
tips	string	无
data	array	无
planeSn	string	整机sn
ft	string	飞行时长（秒）
lon	string	经度
lat	string	纬度
th	string	气压高度
ksd	string	空速度
dsd	string	地速度
dl	string	电量
dy	string	电压
gxs	string	gps星数
dx	string	定向状态
y	string	航向角度

5.2.3. 地面站状态数据接口

功能：获取地面站状态数据

调用：v3/openapi/live/getPadDetailInfo（调用频率5秒/次左右）

请求类型：post

请求参数：

参数	必选	类型	默认值	说明
time	是	string		时间戳(秒)
v	是	string	9-1-1.0.1-1-0	版本号（固定值）
sign	是	string		签名
access_token	是	string		获取的AccessToken
psn	是	string		飞机sn
client_id	是	string		分配的client_id

返回示例：
{
"status": 1,
"tips": "操作成功",
"data": {
    "planeSn": "STWTEST0000002",
    "xh": "ZT-T12",
    "appv": "2.2.1-beta.1",
    "wd": "35",
    "zl": "-40",
    "pl": "1306",
    "qx": "854*480",
    "bit": 2364,
    "flow": "295"
    }
}

返回说明：

参数名	类型	说明
status	string	无
tips	string	无
data	array	无
planeSn	string	整机sn
xh	string	遥控器型号
appv	string	APP版本
wd	string	PAD-温度
zl	string	网络信号质量
pl	string	PAD-CPU频率
qx	string	图像分辨率
bit	string	视频码率
flow	string	数据带宽

5.2.4. 获取直播信息接口

功能：获取直播信息数据

调用：v3/openapi/live/apply（调用频率1~2秒/次左右）

请求类型：post

请求参数：

参数	必选	类型	默认值	说明
time	是	string		时间戳(秒)
v	是	string	9-1-1.0.1-1-0	版本号（固定值）
sign	是	string		签名
access_token	是	string		获取的AccessToken
psn	是	string		飞机sn
client_id	是	string		分配的client_id

返回示例：
{
"status": 1,
"tips": "操作成功",
"data": {
    "height": "291",
    "yaw": "236.1",
    "live_url": "https://yxapi.tusuav.com/202111021203236805.m3u8",
    "lon": "121.0735626",
    "lat": "27.7838078"
    }
}

返回说明：

参数名	类型	说明
status	string	无
tips	string	无
data	array	无
height	string	气压高度
yaw	string	航向角度
live_url	string	m3u8地址
lon	string	经度
lat	string	纬度