# NAYOTA API ## Docs - [产品介绍](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2445354.md): - [应用场景](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2445356.md): - [常见问题](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2445355.md): - 生成token凭证 [生成token凭证教程](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2451867.md): - 入门实例DEMO [获取温度传感器测量数据](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2473715.md): - 入门实例DEMO [获取空开状态数据](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2475463.md): - 入门实例DEMO [获取摄像头图像数据](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2478797.md): - 入门实例DEMO [获取电表统计数据](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2482491.md): - 设备分组类接口 [接口调用实例](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2452693.md): - [数据记录类接口](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/folder-16108221.md): - 数据记录类接口 [接口调用实例](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2445359.md): - 能耗统计类接口 [接口调用实例](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2445358.md): - 图像监控类接口 [接口调用实例](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/doc-2445360.md): ## API Docs - 生成token凭证 [获取token](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915633.md): 用户若需要调用API获取数据，首先需要用用户名和密码调用获取token接口，获取到对应用户的token。 然后在实际请求时在http的header中添加属性： - 设备分组类接口 [根据条件查询通用设备信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915634.md): 如果需要查询某个设备的信息，可以通过指定设备类型model，以及输入条件来筛选指定的设备，例如设备类型、设备名称等。接口将返回符合条件的设备基本信息。这样就可以实现设备信息的查询和管理了。所有的设备都有这些Api接口，只是不同的设备的字段和数据有所不同。 设备类型model有： - 设备分组类接口 [根据条件查询检测设备信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-81670047.md): **检测器**是物联网设备上的一个单独的传感器，它可以测量某个特定的值，比如温度、湿度、光照强度等。如果您想要查询某个检测器的信息，可以输入一些条件来筛选出符合要求的检测器值，比如设备名称、检测器类型等。接口会返回符合条件的检测器的基本信息。 - 设备分组类接口 [根据条件查询控制设备信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-81677041.md): **控制器**是物联网设备中的一个重要组件，它可以控制设备的某些功能，比如开关、调节亮度等。在继电器设备中，单个继电器就是一个控制器。如果您想要查询某个控制器的信息，可以通过输入条件来筛选出符合要求的控制器，比如设备名称等。接口会返回符合条件的控制器的基本信息。 - 设备分组类接口 [通过id查询单个设备信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915635.md): 如果想通过id查询设备的信息，可以在这个接口下输入设备id，接口会根据id来查询设备，并返回设备基本信息，包括名称、型号、状态等。需要注意的是，id是设备的唯一标识符，因此在输入正确的设备id的前提下，接口只会返回唯一一个设备信息。如果你想查询所有或多个设备的信息，可以使用[**根据条件查询通用设备信息**](api-80915634)这个接口 - 设备分组类接口 [通过id查询单个检测设备信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-82807684.md): 输入正确的检测器id，接口会根据id来查询检测器设备，并返回设备的详细信息。检测器id也是检测器设备的唯一标识符，因此在输入正确的检测器id的前提下，接口只会返回一个检测器设备的详细信息。如果你想查询多个检测器设备的信息，可以使用[**根据条件查询检测设备信息**](api-81670047)接口，并输入正确的筛选条件。 - 设备分组类接口 [通过id查询单个控制设备信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-82906366.md): 通过id查询单个控制设备信息，接口会根据输入的id来查询控制器设备，并返回控制器设备的详细信息。同样，输入正确的控制器id的前提下，接口只会返回唯一一个控制器设备的详细信息。查询多个控制器设备的信息，请使用[**根据条件查询控制设备信息**](api-81677041)接口，得到符合条件的所有控制器的基本信息。 - 数据记录类接口 [通过id查询检测器检测数据记录](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915641.md): **检测数据记录**就是检测节点所采集的数据的记录，可以用来监测和分析各种监测值。通过这个接口，我们可以输入一个id来查询对应的检测数据记录，快速获取所需的数据信息。 - 数据记录类接口 [通过id查询控制器控制数据记录](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915644.md): **控制数据记录**就是记录和存储控制类设备所产生的数据，比如设备的运行状态和记录时间等。如果你需要查询某个具体设备的控制数据记录，可以通过输入设备的id来获取指定的记录，快速管理和查询数据了。 - 数据记录类接口 [根据条件查询消息推送记录](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915645.md): **推送数据记录**是设备所产生的数据自动推送到指定的接收端。通过实时推送这些数据，可以让用户及时了解设备的运行情况。如果需要推送某个具体设备的数据记录，可以通过条件来筛选指定的推送对象，这样就可以更方便地实现数据的推送和管理了。 - 数据记录类接口 [通过id查询视频录制记录](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-82802057.md): **视频录制记录**是摄像头所采集的视频数据的记录存储，这些数据包括录制时间、录制内容等。如果需要查询某个设备的视频录制记录，可以通过输入摄像头设备的id来获取指定的记录。同时，视频录制记录也可以用于安全监控、追溯等方面，具有非常重要的应用价值。 - 能耗统计类接口 [根据条件查询设备层级信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-81323328.md): **设备层级信息**接口可以帮助用户查询指定层级的层级信息，就像我们把相同类型的东西放在同一个抽屉里一样，这个接口可以把相同类型的计量设备归类到同一个层级里。用户可以根据自己的需求选择合适的查询条件，如层级名称。查询结果可以告诉用户这个设备层级的基本信息。 - 能耗统计类接口 [根据条件查询分项区间信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-83032937.md): **分项数据**就是将相关区域的计量设备进行归类，配置在同一区域的计量设备为同一分项。用户可以根据自己的需求选择合适的查询条件，比如区域名称等。查询结果会返回这个设备分项的基本信息，调用接口的方式与查询设备层级信息的接口类似。 - 能耗统计类接口 [通过id查询设备层级统计数据](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915640.md): 通过id查询设备层级统计数据，可以查询特定设备层级的统计数据。值得注意的是，这个接口只能查询某一层级的统计数据，不能查询所有层级的统计数据。如果需要查询所有或多个计量设备层级的统计数据，可以使用[**根据条件查询设备层级信息**](api-81323328)接口进行查询。 - 能耗统计类接口 [通过id查询分项区间统计数据](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915639.md): 通过id查询分项区间统计数据，可以查询特定分项区间的统计数据。如果想要查询多个分项信息，请使用[**根据条件查询分项区间信息**](api-83032937)进行查询，这个接口可以根据你提供的条件查询符合条件的所有分项区间信息。 - 能耗统计类接口 [查询单个层级月度能耗统计](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-81308937.md): **查询月度能耗统计数据**就是从能耗统计数据中筛选出指定时间范围内的月度能耗数据。这个接口可以帮助用户了解某个时间段内某个层级的能耗情况，方便用户进行能源管理和节能减排。 - 部门层级类接口 [根据条件查询部门层级信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915643.md): 在这个接口下，用户可以根据自己的需求输入合适的查询条件，比如部门层级名称。然后接口会返回符合条件的层级基本信息，这样用户可以更好地了解和管理这个部门层级。 - 部门层级类接口 [通过id查询单个部门层级信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915642.md): 根据层级id查询单个部门层级信息。用户需要提供部门层级id作为查询条件，接口会根据这个id查询符合条件的部门层级信息，并将查询结果返回。一般来说，该接口只会返回一个部门层级的基本信息，如果想要查看多个部门层级，请参考[**根据条件查询部门层级信息**](api-80915643)这个接口。 - 图像监控类接口 [根据条件查询人脸信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915647.md): 这个接口是用来根据查询条件查询人脸库列表的。用户需要提供一些查询条件，比如人脸库名称等，然后接口会根据这些条件查询符合条件的人脸库信息，并将查询结果以列表的形式返回给用户。 - 图像监控类接口 [根据条件查询摄像头信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-81335637.md): 这个接口是用来根据查询条件查询摄像头信息列表的。用户需要提供一些查询条件，比如摄像头名称、所属区域、安装时间等，然后接口会根据这些条件查询符合条件的摄像头信息，并将查询结果以列表的形式返回给用户。 - 图像监控类接口 [通过id查询单个摄像头信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-81659334.md): 这个接口是用来根据摄像头设备id查询摄像头信息列表的。用户需要提供摄像头设备id作为查询条件，然后接口会根据这个id查询符合条件的摄像头信息，并将查询结果以单个摄像头信息的形式返回给用户。 - 用户组织类接口 [根据条件查询用户信息列表](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915636.md): 这个接口是用来根据查询条件查询用户信息列表的。用户需要提供一些查询条件，比如用户名、邮箱、手机号等，然后接口会根据这些条件查询数据库中符合条件的用户信息。 - 用户组织类接口 [通过id查询单个用户信息](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-80915637.md): 这个接口是用来根据id查询单个用户信息的。用户需要提供用户id作为查询条件，然后接口会根据这个id查询符合条件的用户信息，并将查询结果以单个用户信息的形式返回给用户。 - [未命名接口](https://apifox.com/apidoc/shared/ccec0973-4442-42f6-9df4-9858065f4100/api-266439508.md):