安防摄像机网页无插件直播方案EasyNVR关于接口调用出现401 Unauthorized问题的解决方法

背景分析

随着互联网基础设施建设的发展，4G/5G/NB-IoT各种网络技术的大规模商用，视频随时随地可看、可控的诉求越来越多，互联网思维、架构和技术引入进传统监控行业里，成为新形势下全终端监控的基础需求。

因使用区域受限、实施成本和入口门槛高，传统监控行业和摄像机直播系统无法借力优质云资源搭建属于自己的监控云平台，客户终端出不了监控的内网，无法做到公网实时监控与录像回放，更别说用手机、微信、H5、无插件随时随地看视频了，EasyNVR一直致力于解决以上痛点。

 

接口调用权限解决

最近有不少开发者就EasyNVR接口调用的问题来咨询我们，开发者们遇到的最多的问题就是权限问题（401 Unauthorized）。EasyNVR为第三方系统和应用提供了标准的API接口，方便对接二次开发为专属于自己企业的互联网直播平台。

接口一般分为接口定义者和接口调用者，定义者可以规定接收参数的类型及返回形式，而接口定义者则只能完全按照接口定义者规定的参数进行访问。就叫是我们所说的webService（网络服务）。

 

接口概述

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	Platform Address	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来进行请求。