You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

688 lines
17 KiB

[
6 years ago
{
"type": "get",
6 years ago
"url": "/api/v1/record/files",
6 years ago
"title": "获取所有录像文件",
"group": "record",
"name": "RecordFiles",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "Number",
"optional": false,
"field": "folder",
"description": "<p>录像文件所在的文件夹</p>"
},
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "start",
"description": "<p>分页开始,从零开始</p>"
},
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "limit",
"description": "<p>分页大小</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "sort",
"description": "<p>排序字段</p>"
},
{
"group": "Parameter",
"type": "String",
"allowedValues": [
"ascending",
"descending"
],
"optional": true,
"field": "order",
"description": "<p>排序顺序</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "q",
"description": "<p>查询参数</p>"
}
]
}
},
"success": {
"fields": {
"200": [
{
"group": "200",
"type": "Number",
"optional": false,
"field": "total",
"description": "<p>总数</p>"
},
{
"group": "200",
"type": "Array",
"optional": false,
"field": "rows",
"description": "<p>文件列表</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.duration",
"description": "<p>格式化好的录像时长</p>"
},
{
"group": "200",
"type": "Number",
"optional": false,
"field": "rows.durationMillis",
"description": "<p>录像时长,毫秒为单位</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.path",
"description": "<p>录像文件的相对路径,录像文件为m3u8格式,将其放到video标签中便可直接播放。其绝对路径为:http[s]://host:port/record/[path]。</p>"
}
]
}
},
"version": "0.0.0",
"filename": "routers/record.go",
"groupTitle": "录像"
},
{
"type": "get",
6 years ago
"url": "/api/v1/record/folders",
6 years ago
"title": "获取所有录像文件夹",
"group": "record",
"name": "RecordFolders",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "start",
"description": "<p>分页开始,从零开始</p>"
},
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "limit",
"description": "<p>分页大小</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "sort",
"description": "<p>排序字段</p>"
},
{
"group": "Parameter",
"type": "String",
"allowedValues": [
"ascending",
"descending"
],
"optional": true,
"field": "order",
"description": "<p>排序顺序</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "q",
"description": "<p>查询参数</p>"
}
]
}
},
"success": {
"fields": {
"200": [
{
"group": "200",
"type": "Number",
"optional": false,
"field": "total",
"description": "<p>总数</p>"
},
{
"group": "200",
"type": "Array",
"optional": false,
"field": "rows",
"description": "<p>文件夹列表</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.folder",
"description": "<p>录像文件夹名称</p>"
}
]
}
},
"version": "0.0.0",
"filename": "routers/record.go",
"groupTitle": "录像"
},
{
"type": "get",
"url": "/api/v1/players",
"title": "获取拉流列表",
"group": "stats",
"name": "Players",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "start",
"description": "<p>分页开始,从零开始</p>"
},
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "limit",
"description": "<p>分页大小</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "sort",
"description": "<p>排序字段</p>"
},
{
"group": "Parameter",
"type": "String",
"allowedValues": [
"ascending",
"descending"
],
"optional": true,
"field": "order",
"description": "<p>排序顺序</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "q",
"description": "<p>查询参数</p>"
}
]
}
},
"success": {
"fields": {
"200": [
{
"group": "200",
"type": "Number",
"optional": false,
"field": "total",
"description": "<p>总数</p>"
},
{
"group": "200",
"type": "Array",
"optional": false,
"field": "rows",
"description": "<p>推流列表</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.id",
"description": ""
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.path",
"description": ""
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.transType",
"description": "<p>传输模式</p>"
},
{
"group": "200",
"type": "Number",
"optional": false,
"field": "rows.inBytes",
"description": "<p>入口流量</p>"
},
{
"group": "200",
"type": "Number",
"optional": false,
"field": "rows.outBytes",
"description": "<p>出口流量</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.startAt",
"description": "<p>开始时间</p>"
}
]
}
},
"version": "0.0.0",
"filename": "routers/stats.go",
6 years ago
"groupTitle": "统计"
},
{
"type": "get",
"url": "/api/v1/pushers",
"title": "获取推流列表",
"group": "stats",
"name": "Pushers",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "start",
"description": "<p>分页开始,从零开始</p>"
},
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "limit",
"description": "<p>分页大小</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "sort",
"description": "<p>排序字段</p>"
},
{
"group": "Parameter",
"type": "String",
"allowedValues": [
"ascending",
"descending"
],
"optional": true,
"field": "order",
"description": "<p>排序顺序</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "q",
"description": "<p>查询参数</p>"
}
]
}
},
"success": {
"fields": {
"200": [
{
"group": "200",
"type": "Number",
"optional": false,
"field": "total",
"description": "<p>总数</p>"
},
{
"group": "200",
"type": "Array",
"optional": false,
"field": "rows",
"description": "<p>推流列表</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.id",
"description": ""
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.path",
"description": ""
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.transType",
"description": "<p>传输模式</p>"
},
{
"group": "200",
"type": "Number",
"optional": false,
"field": "rows.inBytes",
"description": "<p>入口流量</p>"
},
{
"group": "200",
"type": "Number",
"optional": false,
"field": "rows.outBytes",
"description": "<p>出口流量</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "rows.startAt",
"description": "<p>开始时间</p>"
},
{
"group": "200",
"type": "Number",
"optional": false,
"field": "rows.onlines",
"description": "<p>在线人数</p>"
}
]
}
},
"version": "0.0.0",
"filename": "routers/stats.go",
6 years ago
"groupTitle": "统计"
},
{
"type": "get",
6 years ago
"url": "/api/v1/stream/start",
"title": "启动拉转推",
6 years ago
"group": "stream",
"name": "StreamStart",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "url",
"description": "<p>RTSP源地址</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": true,
"field": "customPath",
"description": "<p>转推时的推送PATH</p>"
},
{
"group": "Parameter",
"type": "String",
"allowedValues": [
"TCP",
"UDP"
],
"optional": true,
"field": "transType",
"defaultValue": "TCP",
"description": "<p>拉流传输模式</p>"
},
6 years ago
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "idleTimeout",
"description": "<p>拉流时的超时时间</p>"
},
{
"group": "Parameter",
"type": "Number",
"optional": true,
"field": "heartbeatInterval",
"description": "<p>拉流时的心跳间隔,毫秒为单位。如果心跳间隔不为0,那拉流时会向源地址以该间隔发送OPTION请求用来心跳保活</p>"
}
]
}
},
"success": {
"fields": {
"200": [
{
"group": "200",
"type": "String",
"optional": false,
"field": "ID",
"description": "<p>拉流的ID。后续可以通过该ID来停止拉流</p>"
}
]
}
},
"version": "0.0.0",
"filename": "routers/streams.go",
"groupTitle": "流管理"
},
{
"type": "get",
6 years ago
"url": "/api/v1/stream/stop",
"title": "停止推流",
6 years ago
"group": "stream",
"name": "StreamStop",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "id",
"description": "<p>拉流的ID</p>"
}
]
}
},
"version": "0.0.0",
"filename": "routers/streams.go",
"groupTitle": "流管理",
"success": {
"examples": [
{
"title": "成功",
"content": "HTTP/1.1 200 OK",
"type": "json"
}
]
}
},
{
"type": "get",
6 years ago
"url": "/api/v1/getserverinfo",
"title": "获取平台运行信息",
"group": "sys",
"name": "GetServerInfo",
"success": {
"fields": {
"200": [
{
"group": "200",
"type": "String",
"optional": false,
"field": "Hardware",
"description": "<p>硬件信息</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "RunningTime",
"description": "<p>运行时间</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "StartUpTime",
"description": "<p>启动时间</p>"
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "Server",
"description": "<p>软件信息</p>"
}
]
}
},
"version": "0.0.0",
"filename": "routers/sys.go",
6 years ago
"groupTitle": "系统"
},
{
"type": "get",
6 years ago
"url": "/api/v1/login",
"title": "登录",
"group": "sys",
"name": "Login",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "username",
"description": "<p>用户名</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "password",
"description": "<p>密码(经过md5加密,32位长度,不带中划线,不区分大小写)</p>"
}
]
}
},
"success": {
"examples": [
{
"title": "成功",
"content": "HTTP/1.1 200 OK\nSet-Cookie: token=s%3ArkyMbQE0M.5AKAOXbW8c7iP%2BOo0venPkCYiEiPK9FY31mB6AlFQak;//用着后续接口调用的 token",
"type": "json"
}
]
},
"version": "0.0.0",
"filename": "routers/sys.go",
6 years ago
"groupTitle": "系统"
},
{
"type": "get",
6 years ago
"url": "/api/v1/logout",
"title": "登出",
"group": "sys",
"name": "Logout",
"version": "0.0.0",
"filename": "routers/sys.go",
6 years ago
"groupTitle": "系统",
"success": {
"examples": [
{
"title": "成功",
"content": "HTTP/1.1 200 OK",
"type": "json"
}
]
}
},
{
"type": "get",
6 years ago
"url": "/api/v1/restart",
"title": "重启服务",
"group": "sys",
"name": "Restart",
"version": "0.0.0",
"filename": "routers/sys.go",
6 years ago
"groupTitle": "系统",
"success": {
"examples": [
{
"title": "成功",
"content": "HTTP/1.1 200 OK",
"type": "json"
}
]
}
},
{
"type": "get",
6 years ago
"url": "/api/v1/userInfo",
"title": "获取当前登录用户信息",
"group": "sys",
"name": "UserInfo",
"version": "0.0.0",
"filename": "routers/sys.go",
6 years ago
"groupTitle": "系统",
"success": {
"fields": {
"200": [
{
"group": "200",
"type": "String",
"optional": false,
"field": "id",
"description": ""
},
{
"group": "200",
"type": "String",
"optional": false,
"field": "name",
"description": "<p>用户名</p>"
},
{
"group": "200",
"type": "String[]",
"optional": true,
"field": "roles",
"description": "<p>角色列表</p>"
}
]
}
}
}
]