背景分析
最近在使用EasyNVR的过程中，很多小伙伴咨询关于接口调用的问题，初步判断应该是遇到权限问题（401 Unauthorized）。EasyNVR为第三方系统和应用提供了标准的API接口，方便对接二次开发为专属于自己企业的互联网直播平台。接口一般分为接口定义者和接口调用者，定义者可以规定接收参数的类型及返回形式，而接口定义者则只能完全按照接口定义者规定的参数进行访问。就叫是我们所说的webService（网络服务）。
本篇博文将基于自身对EasyNVR接口的调用和一些用户的反馈的问题来对接口调用进行说明：
接口概述
API采用Restful风格的Http协议，全部请求都使用Get/Post方式，字符不区分大小写。基本结构如下：
http://<IP>:<Port>/api/<Version>/<Action>?<Param1>=<value>&<Param2>=<Value>&.....
参数
| 参数名称 | 定义 | 说明 |
| IP | Platform Address | IP地址 |
| Port | Platform Port | 通讯端口 |
| Version | API Version | API版本 |
| Action | Action | 执行的操作 |
| Param | Action Parameter | 操作所使用的参数，可以有多个参数，每个参数对应一个Value。 |
| Value | Parameter Value | 参数值，如果Value的字符串中出现&等特殊字符，则必须用””包住Value。 |
返回值
调用API会返回Json字符串，代表操作返回的结果
{
"EasyDarwin" : {
"Body" : {
……
},
"Header" : {
"CSeq" : "1",
"ErrorNum" : "200",
"ErrorString" : "Success OK",
"MessageType" : "MSG_SC_API_ACK",
"Version" : "1.0"
}
}
}
接口的调用
许多小伙伴只注重接口的功能，往往直接传参调接口，于是就出现开篇的401报错；最简单的方法是，在我们拿到接口文档后，可以先阅读一下文档，做到心中有数；
接口调用前先进行简单的说明：EasyNVR大部分的调用接口需要在cookie中携带token信息；对于这个token信息，是通过login接口返回的。当我们成功请求接口: ”/api/v1/login?username=xxx&password=xxx“时，会返回一个token信息；
{
"EasyDarwin" : {
"Body" : {
"Token" : "a19cb5f6e7d2449d8d24c8a0fc554ca7"
},
"Header" : {
"CSeq" : "1",
"ErrorNum" : "200",
"ErrorString" : "Success OK",
"MessageType" : "MSG_SC_SERVER_LOGIN_ACK",
"Version" : "1.0"
}
}
}
我们对获取到的token信息存储到cookie中。出现401，大多数情况是cookie中tooken的携带、接口格式的错误、传递参数的错误。
友情提示： 有的大兄弟在请求login接口时就发现出现401权限限制；该接口中password是经过MD5加密的。在进行其他接口请求时在request headers 的cookie会携带对应的tooken来进行请求。
实例展示如下：
首先引入jqueryCookie，用于设置cookie(如果有其他方法设置cookie可以不用引用)
<script src="/adminlte-2.3.6/plugins/cookie/jquery.cookie.min.js"></script>
通过ajax来进行卡接口的请求
- 在没有调用接口进行设置前
$.ajax({
type: "GET",
url: "api/v1/login",
data: {
username: username,
password: password
},
global: false,
success: function(data) {
try {
var ret = JSON.parse(data);
var token = ret.EasyDarwin.Body.Token;
$.cookie("token", token);
//将tooken设置进cookie中
$.cookie("username", username);
} catch (e) {
console.log(e);
}
},
通过ajax请求成功后对获得数据的处理，将tooken出入cookie中：
- 调用接口并进行cookie设置后：
此时当我们进行其他接口的请求时，会发现在request header 存在cookie tooken，并且可以成功请求接口。
EasyNVR硬件设备
EasyNVR智能云终端硬件设备，填补了互联网直播行业设备空白，软硬一体，云端运维。体积小，方便放置部署；7*24小时不间断运行，低功耗；省去自建视频服务器高额费用；专属视频服务，免除了与其他硬件的相互影响，通电联网即可成功运行，部署操作简单。
EasyNVR应用场景
EasyNVR可以说已经成为国内视频互联网化基础建设的排头兵，几乎各个民生行业都已经有了EasyNVR视频能力输出的身影，EasyNVR多年服务于各行各业视频基础建设，EasyNVR的可靠性、完整性、稳定性已经受到了业界的广泛认可！
通过将景区的摄像头通过EasyNVR系统可以使管理部门建设掌上视频监管系统（景区内部使用）方便随时随地查各个景区的情况。同时可以将景区的经典风景通过微信、微博、网站和APP等方式对公众展示，用于宣传景区风景，展示景区魅力，提高景区知名度。
目前各地市社会视频资源存在种类繁多，各系统独立运行，没有有效整合和联网应用，通过EasyNVR系统，将各类视频资源整合，统一管理、统一调度，资源共享，实现了资源利用最大化，避免了重复建设。
把传统分散的校园监控汇总到EasyNVR系统，实现把传统的本地监控提升到随时随地的远程监控，把传统的纯粹的监控上升到管理，使视频监控成为学校教学管理的有力工具。更重要的是让家长一起参与，提升教学的主动性。提升学校声誉和学校品牌。
将工地的摄像头通过平台对施工方、监理方和监管部门开放，方便实时了解工程进度，工地人员安全以及财产情况，自成力能平台，专为工地构建的视频监控平台。
而随着互联网和移动互联网被广大消费者接受，“社会共治”将是是明厨亮灶目前的核心理念。采用社会共治方式，将各餐饮企业的后厨视频通过EasyNVR系统让老百姓通过手机可实时看到后厨的情况，既起到全社会监督的效果也是对餐饮企业的宣传。
EasyNVR安防摄像机网页流媒体服务
EasyNVR是一款拥有完整、自主、可控知识产权，同时又能够具备软硬一体功能的安防互联网化流媒体服务器，能够通过简单的网络摄像机通道配置，将传统监控行业里面的高清网络摄像机IP Camera、NVR等具有RTSP、Onvif协议输出的设备接入到EasyNVR，EasyNVR能够将这些视频源的音视频数据进行拉取，转换为RTMP/HLS，进行全平台终端H5直播（Web、Android、iOS），并且EasyNVR能够将视频源的直播数据对接到第三方CDN网络，实现互联网级别的直播分发。详情可访问EasyNVR官网：http://www.easynvr.com