全新司空 2 OpenAPI V1.0
  1. 旁路推流(仅支持私有云)
全新司空 2 OpenAPI V1.0
  • 认证鉴权
    • 认证鉴权教程
  • 系统服务
    • 司空公有云接入点信息
    • 查询司空 2 系统状态
      GET
  • 组织项目
    • 组织项目教程
    • 获取组织下的项目列表
      GET
    • 获取组织下的设备列表
      GET
    • 获取项目下的设备列表
      GET
    • 获取项目的存储上传凭证
      GET
    • 添加人员到项目
      PUT
  • 设备管理
    • 设备管理教程
    • 物模型获取
      GET
    • HMS信息获取
      GET
    • 实时控制指令下发
      POST
    • 机场相机切换
      POST
    • 飞行器镜头切换
      POST
    • 控制权获取
      POST
    • 控制权释放
      DELETE
    • 图传清晰度设置
      PUT
    • 自定义网络RTK标定
      POST
    • 指定设备进入中继对频模式(仅支持私有云与中继设备)
      POST
    • 查询中继对频的结果(仅支持私有云与中继设备)
      GET
  • 直播管理
    • 直播管理教程
    • 直播推流
      • 开启直播
    • 旁路推流(仅支持私有云)
      • 码流转发错误码
      • 创建码流转发器
        POST
      • 开启/关闭码流转发器
        PUT
      • 获取码流转码器列表
        GET
      • 删除码流转发器
        DELETE
  • 任务管理
    • 任务管理教程
    • 创建飞行任务
    • 更新飞行任务状态
    • 获取飞行任务信息
    • 获取飞行任务列表
    • 获取飞行任务产生的媒体资源
    • 获取飞行任务轨迹信息
  • 航线管理
    • 航线管理教程
    • 航线上传完成通知
    • 获取项目下的航线列表
    • 获取航线详情
  • 模型管理
    • 模型管理教程
    • 模型重建坐标系
    • 获取项目下的模型列表
    • 模型重建
    • 获取模型详情
  • 标注管理
    • 标注管理教程
    • 创建地图标注
  1. 旁路推流(仅支持私有云)

创建码流转发器

开发中
POST
https://es-flight-api-cn.djigate.com/openapi/v0.1/live-stream/converter
创建码流转发器,调用此接口将在司空 2 上创建和存储码流转发器,可调用获取码流转发器列表获取已创建的码流转发器,然后调用开启/关闭码流转发器开启码流转发功能。
最多创建 20个码流转发器。

请求参数

Authorization
在 header 添加参数
X-User-Token
示例:
X-User-Token: ********************
Header 参数
X-Request-Id
string <uuid>
请求唯一标识
必需
默认值:
{{$string.uuid}}
X-Language
enum<string> 
可选
枚举值:
zhen
默认值:
zh
X-Project-Uuid
string 
项目编号
可选
默认值:
{{X-Project-Uuid}}
X-User-Token
string 
必需
X-User-Token
默认值:
{{X-User-Token}}
Body 参数application/json
converter_name
string 
必需
运行中的转码器名称,此名称不能重复,同时sn/camera_index/rtmp_url三个参数不能和已创建且生效中的转码器相同。
sn
string 
必需
码流源设备的sn序列号,如机场SN或者飞行器SN
camera_index
string 
必需
相机索引,此参数可通过获取设备列表中data.list.drone.camera_list.camera_index传入。
schema
string 
参数
必需
schema_option
参数选项
必需
Any of
url
string 
RTMP服务器地址
可选
当schema为rtmp时,必填url(推流地址)
示例
{
    "converter_name": "my_converter",
    "sn": "4SEDL9F0011RY2",
    "camera_index": "165-0-7",
    "schema": "rtmp",
    "schema_option": {
        "url": "rtmp://live.restream.io/live/re_7734128_5da13a862901ce2d4084"
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://es-flight-api-cn.djigate.com/openapi/v0.1/live-stream/converter' \
--header 'X-Request-Id;' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}' \
--header 'Content-Type: application/json' \
--header 'X-User-Token;' \
--data-raw '{
    "converter_name": "my_converter",
    "sn": "4SEDL9F0011RY2",
    "camera_index": "165-0-7",
    "schema": "rtmp",
    "schema_option": {
        "url": "rtmp://live.restream.io/live/re_7734128_5da13a862901ce2d4084"
    }
}'

返回响应

🟢200成功
application/json
Body
code
integer 
非0代表异常
必需
message
string 
消息通知
必需
data
object 
必需
converter_id
string 
必需
转码器ID,转码器的唯一标识。
示例
{
    "code": 0,
    "message": "",
    "data": {
        "converter_id": "acfb0e79-87a7-4d61-898e-2f32792996e5"
    }
}
上一页
码流转发错误码
下一页
开启/关闭码流转发器
Built with