萤石开放平台——怎么通过API接口远程添加摄像头？

高科技摄像头特别是海康萤石摄像头，已经不再只局限于简单的视频功能，特别是智能AI的普及，摄像头也华丽变身成了一个个独立的智能个体，可以实现人脸抓拍，人形检测，客流统计等店铺值守场景，也可以实现安全帽识别，车辆识别，非法入侵识别等智慧工地场景。但用户也许会问，摄像头又不会说话，他得知的这些信息怎么告诉我们，还是说需要配一个主机去处理，这成本又有点太高了。这点正是萤石云要为大家解决的，下面来介绍下如何让设备更简便智能的说话。

API（应用程序编程接口）提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力。形象一点API可以理解为一个管道，通过该管道，可以传入约定好的命令，来获得摄像头的反馈，通过管道“大喊向左转”，然后得到摄像头的反馈“抱歉，我不具备这样的能力”。老规矩，使用萤石云的能力得先添加设备，之前添加设备已经出过一篇文章，可以通过app直接添加，但如果我想要做一个自己的app，或者想要用接口添加设备要怎么操作呢？

跟着我们的步骤一步一步来吧！

1.先来了解下我们的设备添加参数

accessToken——身份令牌，表明我是谁

deviceSerial——设备序列号，表明我要添加的设备是哪只

validateCode——设备验证码，表明这个设备的密码是什么

这些要素缺一不可，因为他们都是必选项，少一个管道就给你一个错误码。不用紧张，这些信息都可以获取到：

获取链接：
萤石开放平台-提供持续稳定的以音视频为主的全场景、多功能综合性服务 (ys7.com)

然后根据截图在对应的位置找到我们的相关参数

测试accessToken可以登录后在开发者服务-我的应用中获取，也可以记录AppKey与Secret调用获取AccessToken的API接口来获得。

设备序列号与设备验证码在摄像头机身的标签里有，如果是老的海康摄像头需要根据其说明手册操作获得验证码。参考渠道产品添加至萤石云方法

注意：添加API不包含配网，所以只支持已经配好网的设备或者连接网线的设备。

2.操作接口

了解API接口看起来很简单，操作起来更加方便，这里需要借助一个第三方工具postman，还没下载的同学赶紧下载起来。上面提到了获取AccessToken的API接口，我们就来看试用下这个工具，首先打开postman，简单了解其布局

对应我们的接口文档

Request URL——请求地址

GET/POST方法

Key——参数名，Value——实际值（填在body中，特殊要求要传Headers的参数除外）

这边的appKey与appSecret可以在上面描述的开发者服务-我的应用中获得，属于账户身份信息，需妥善保管不可泄露。

3.API返回内容

API的调用只成功了一半，还需要能理解其返回的内容，这才是解析设备语言的关键步骤。结合接口文档返回字段

获取到的accessToken就是上面添加接口的身份令牌，可以用于调用添加等其他接口。具体过期时间是该身份令牌的过期时间，过期后需要重新获取，一个accessToken有效期为7天，建议6天左右可以重新获取刷新令牌。

4.代码示例

Postman还有一大优势就是他可以提供各种语言的代码示例，方便学习与参考：

学习了API的使用方法，就可以来体验摄像头的高端玩法了，还真有摄像头支持“向左转”，云台摄像头再结合我们的云台API接口就可以实现。