define({ "api": [ { "type": "get", "url": "/api/vi/record/files", "title": "获取所有录像文件", "group": "record", "name": "RecordFiles", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "Number", "optional": false, "field": "folder", "description": "

录像文件所在的文件夹

" }, { "group": "Parameter", "type": "Number", "optional": true, "field": "start", "description": "

分页开始,从零开始

" }, { "group": "Parameter", "type": "Number", "optional": true, "field": "limit", "description": "

分页大小

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "sort", "description": "

排序字段

" }, { "group": "Parameter", "type": "String", "allowedValues": [ "ascending", "descending" ], "optional": true, "field": "order", "description": "

排序顺序

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "q", "description": "

查询参数

" } ] } }, "success": { "fields": { "200": [ { "group": "200", "type": "Number", "optional": false, "field": "total", "description": "

总数

" }, { "group": "200", "type": "Array", "optional": false, "field": "rows", "description": "

文件列表

" }, { "group": "200", "type": "String", "optional": false, "field": "rows.duration", "description": "

格式化好的录像时长

" }, { "group": "200", "type": "Number", "optional": false, "field": "rows.durationMillis", "description": "

录像时长,毫秒为单位

" }, { "group": "200", "type": "String", "optional": false, "field": "rows.path", "description": "

录像文件的相对路径,录像文件为m3u8格式,将其放到video标签中便可直接播放。其绝对路径为:http[s]://host:port/record/[path]。

" } ] } }, "version": "0.0.0", "filename": "routers/record.go", "groupTitle": "录像" }, { "type": "get", "url": "/api/vi/record/folders", "title": "获取所有录像文件夹", "group": "record", "name": "RecordFolders", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "Number", "optional": true, "field": "start", "description": "

分页开始,从零开始

" }, { "group": "Parameter", "type": "Number", "optional": true, "field": "limit", "description": "

分页大小

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "sort", "description": "

排序字段

" }, { "group": "Parameter", "type": "String", "allowedValues": [ "ascending", "descending" ], "optional": true, "field": "order", "description": "

排序顺序

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "q", "description": "

查询参数

" } ] } }, "success": { "fields": { "200": [ { "group": "200", "type": "Number", "optional": false, "field": "total", "description": "

总数

" }, { "group": "200", "type": "Array", "optional": false, "field": "rows", "description": "

文件夹列表

" }, { "group": "200", "type": "String", "optional": false, "field": "rows.folder", "description": "

录像文件夹名称

" } ] } }, "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": "

分页开始,从零开始

" }, { "group": "Parameter", "type": "Number", "optional": true, "field": "limit", "description": "

分页大小

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "sort", "description": "

排序字段

" }, { "group": "Parameter", "type": "String", "allowedValues": [ "ascending", "descending" ], "optional": true, "field": "order", "description": "

排序顺序

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "q", "description": "

查询参数

" } ] } }, "success": { "fields": { "200": [ { "group": "200", "type": "Number", "optional": false, "field": "total", "description": "

总数

" }, { "group": "200", "type": "Array", "optional": false, "field": "rows", "description": "

推流列表

" }, { "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": "

传输模式

" }, { "group": "200", "type": "Number", "optional": false, "field": "rows.inBytes", "description": "

入口流量

" }, { "group": "200", "type": "Number", "optional": false, "field": "rows.outBytes", "description": "

出口流量

" }, { "group": "200", "type": "String", "optional": false, "field": "rows.startAt", "description": "

开始时间

" } ] } }, "version": "0.0.0", "filename": "routers/stats.go", "groupTitle": "统计" }, { "type": "get", "url": "/api/v1/pushers", "title": "获取推流列表", "group": "stats", "name": "Pushers", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "Number", "optional": true, "field": "start", "description": "

分页开始,从零开始

" }, { "group": "Parameter", "type": "Number", "optional": true, "field": "limit", "description": "

分页大小

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "sort", "description": "

排序字段

" }, { "group": "Parameter", "type": "String", "allowedValues": [ "ascending", "descending" ], "optional": true, "field": "order", "description": "

排序顺序

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "q", "description": "

查询参数

" } ] } }, "success": { "fields": { "200": [ { "group": "200", "type": "Number", "optional": false, "field": "total", "description": "

总数

" }, { "group": "200", "type": "Array", "optional": false, "field": "rows", "description": "

推流列表

" }, { "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": "

传输模式

" }, { "group": "200", "type": "Number", "optional": false, "field": "rows.inBytes", "description": "

入口流量

" }, { "group": "200", "type": "Number", "optional": false, "field": "rows.outBytes", "description": "

出口流量

" }, { "group": "200", "type": "String", "optional": false, "field": "rows.startAt", "description": "

开始时间

" }, { "group": "200", "type": "Number", "optional": false, "field": "rows.onlines", "description": "

在线人数

" } ] } }, "version": "0.0.0", "filename": "routers/stats.go", "groupTitle": "统计" }, { "type": "get", "url": "/api/vi/stream/start", "title": "启动拉流", "group": "stream", "name": "StreamStart", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "url", "description": "

RTSP源地址

" }, { "group": "Parameter", "type": "String", "optional": true, "field": "customPath", "description": "

转推时的推送PATH

" }, { "group": "Parameter", "type": "Number", "optional": true, "field": "idleTimeout", "description": "

拉流时的超时时间

" }, { "group": "Parameter", "type": "Number", "optional": true, "field": "heartbeatInterval", "description": "

拉流时的心跳间隔,毫秒为单位。如果心跳间隔不为0,那拉流时会向源地址以该间隔发送OPTION请求用来心跳保活

" } ] } }, "success": { "fields": { "200": [ { "group": "200", "type": "String", "optional": false, "field": "ID", "description": "

拉流的ID。后续可以通过该ID来停止拉流

" } ] } }, "version": "0.0.0", "filename": "routers/streams.go", "groupTitle": "流管理" }, { "type": "get", "url": "/api/vi/stream/stop", "title": "停止拉流", "group": "stream", "name": "StreamStop", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "id", "description": "

拉流的ID

" } ] } }, "version": "0.0.0", "filename": "routers/streams.go", "groupTitle": "流管理", "success": { "examples": [ { "title": "成功", "content": "HTTP/1.1 200 OK", "type": "json" } ] } }, { "type": "get", "url": "/getserverinfo", "title": "获取平台运行信息", "group": "sys", "name": "GetServerInfo", "success": { "fields": { "200": [ { "group": "200", "type": "String", "optional": false, "field": "Hardware", "description": "

硬件信息

" }, { "group": "200", "type": "String", "optional": false, "field": "RunningTime", "description": "

运行时间

" }, { "group": "200", "type": "String", "optional": false, "field": "StartUpTime", "description": "

启动时间

" }, { "group": "200", "type": "String", "optional": false, "field": "Server", "description": "

软件信息

" } ] } }, "version": "0.0.0", "filename": "routers/sys.go", "groupTitle": "系统" }, { "type": "get", "url": "/login", "title": "登录", "group": "sys", "name": "Login", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "username", "description": "

用户名

" }, { "group": "Parameter", "type": "String", "optional": false, "field": "password", "description": "

密码(经过md5加密,32位长度,不带中划线,不区分大小写)

" } ] } }, "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", "groupTitle": "系统" }, { "type": "get", "url": "/logout", "title": "登出", "group": "sys", "name": "Logout", "version": "0.0.0", "filename": "routers/sys.go", "groupTitle": "系统", "success": { "examples": [ { "title": "成功", "content": "HTTP/1.1 200 OK", "type": "json" } ] } }, { "type": "get", "url": "/restart", "title": "重启服务", "group": "sys", "name": "Restart", "version": "0.0.0", "filename": "routers/sys.go", "groupTitle": "系统", "success": { "examples": [ { "title": "成功", "content": "HTTP/1.1 200 OK", "type": "json" } ] } }, { "type": "get", "url": "/userInfo", "title": "获取当前登录用户信息", "group": "sys", "name": "UserInfo", "version": "0.0.0", "filename": "routers/sys.go", "groupTitle": "系统", "success": { "fields": { "200": [ { "group": "200", "type": "String", "optional": false, "field": "id", "description": "" }, { "group": "200", "type": "String", "optional": false, "field": "name", "description": "

用户名

" }, { "group": "200", "type": "String[]", "optional": true, "field": "roles", "description": "

角色列表

" } ] } } } ] });