本文共 1277 字，大约阅读时间需要 4 分钟。

背景分析

随着互联网基础设施的不断发展，4G、5G、NB-IoT等网络技术的快速普及，视频随时随地观看和控制的需求日益增加。互联网思维和技术逐渐融入传统监控行业，成为实现全终端监控的重要基础需求。

传统监控行业和摄像机直播系统由于区域受限和实施成本高等原因，难以借助优质云资源构建专属监控云平台。客户端无法进入内网，实时监控与录像回放功能也难以实现，更遑论通过手机、微信、H5或无插件手段随时随地查看视频了。EasyNVR始终致力于解决这些痛点，为监控系统提供更为便捷高效的解决方案。

接口调用权限问题

近期有不少开发者咨询关于EasyNVR接口调用的问题，其中最常见的问题莫过于权限问题（401 Unauthorized）。EasyNVR为第三方系统和应用提供了标准化的API接口，方便开发者根据需求构建专属的互联网直播平台。

API接口的设计遵循Restful风格，使用Http协议进行操作，所有请求均以Get/Post方式发送，字符大小写不区分。基本接口结构如下：

/api/v1/{version}/{action}?param1=value1[param2=value2]...

参数说明

| 参数名称 | 定义 | 说明 ||--------------|----------------------------------------|------------|| IP | Platform Address | IP地址 || Port | Platform Port | 通讯端口 || Version | Platform Address | API版本 || Action | Action | 执行的操作 || Param | Action Parameter | 操作参数 || Value | Parameter Value | 参数值 |

注：如果Value中包含特殊字符（如&），需用引号括起来。

返回值示例

{"EasyDarwin": {"Body": {"Token": "a19cb5f6e7d2449d8d24c8a0fc554ca7"},"Header": {"CSeq": "1","ErrorNum": "200","ErrorString": "Success OK","MessageType": "MSG_SC_SERVER_LOGIN_ACK","Version": "1.0"}}}

接口调用注意事项

• EasyNVR的大多数接口调用需要在cookie中携带token信息。此token通过登录接口获取。例如，调用 /api/v1/login?username=xxx&password=xxx 可获得有效token。
• 如果出现401权限错误，通常是由于cookie中缺少或错误token、接口请求格式错误或参数传递错误。

友情提示

在登录接口时，注意到password字段需要进行MD5加密处理。其他接口请求时，需在request headers中携带相应的cookie以继续操作。