# 查询

当您已经知道需要哪个读取操作，并想要 Luxonis Hub GraphQL 控制 API 的精确公开查询接口时，请使用此页面。每个支持的查询都有其独立的章节，以便您可以直接链接到它。

> **公开查询接口**
> 公开根查询类型是
> `PublicQuery`
> 。大多数操作查询在
> `team { ... }`
> 下可用。

## 关于查询

每个 GraphQL 模式都有一个根查询类型。在 Luxonis Hub 中，公开根查询类型是 PublicQuery。

使用此页面可以：

 * 检查某个字段是否属于支持的公开接口
 * 确认确切的参数名称和类型
 * 直接从指南或变更日志条目链接到一个查询字段

如果您需要输入对象详细信息，例如 DevicesFilterInput 或 EventSnapFilterInput，请继续阅读
[模式](https://docs.luxonis.com/cloud/api/reference/control-api/schema.md) 或通过自省检查实时模式。

## status

返回一个基本的 API 状态字符串。

路径： status

类型： String!

## publicApp

通过 ID 获取一个公开应用。

路径： publicApp

类型： AppDetail

### publicApp 的参数

 * appId (ID!)：要获取的公开应用的 ID。

## publicApps

使用游标分页列出公开应用。

路径： publicApps

类型： AppConnection!

### publicApps 的参数

 * after (String)：返回指定游标之后的项目。
 * first (Int)：返回列表中的前 n 个项目。
 * orderBy (AppOrderBy)：返回应用的排序顺序。

## team

进入经过身份验证的团队作用域查询接口。

路径： team

类型： TeamScopedQueries!

此页面上的所有剩余查询章节都嵌套在 team 下，并使用路径 team.<field>。

## adoptKey

通过 ID 获取一个采用密钥。

路径： team.adoptKey

类型： TeamAdoptKey

### adoptKey 的参数

 * adoptKeyId (ID!)：要获取的采用密钥的 ID。

## adoptKeys

列出经过身份验证的团队的采用密钥。

路径： team.adoptKeys

类型： TeamAdoptKeyConnection!

### adoptKeys 的参数

 * after (String)：返回指定游标之后的项目。
 * first (Int)：返回列表中的前 n 个项目。
 * orderBy (TeamAdoptKeyOrderBy)：返回的采用密钥的排序顺序。

## app

通过 ID 获取团队可见的一个应用。

路径： team.app

类型： AppDetail

### app 的参数

 * appId (ID!)：要获取的应用的 ID。

## appRelease

通过 ID 获取一个应用发布版本。

路径： team.appRelease

类型： AppReleaseWithDetail

### appRelease 的参数

 * appReleaseId (ID!)：要获取的应用发布版本的 ID。

## apps

列出团队可见的应用。

路径： team.apps

类型： AppConnection!

### apps 的参数

 * after (String)：返回指定游标之后的项目。
 * filter (AppsFilterInput)：返回应用的过滤选项。
 * first (Int)：返回列表中的前 n 个项目。
 * orderBy (AppOrderBy)：返回应用的排序顺序。

## device

通过 ID 获取一个设备。

路径： team.device

类型： DeviceWithDetail

### device 的参数

 * deviceId (ID!)：要获取的设备的 ID。

## deviceApp

通过 ID 获取一个已安装的设备应用。

路径： team.deviceApp

类型： DeviceAppDetail

### deviceApp 的参数

 * id (ID!)：要获取的已安装设备应用的 ID。

## deviceApps

列出一个设备的已安装设备应用。

路径： team.deviceApps

类型： DeviceAppConnection!

### deviceApps 的参数

 * after (String)：返回指定游标之后的项目。
 * deviceId (ID!)：要列出其已安装应用的设备的 ID。
 * first (Int)：返回列表中的前 n 个项目。
 * orderBy (DeviceAppOrderBy)：返回的设备应用的排序顺序。

## deviceGroup

通过其 ID 查找单个设备组。

路径： team.deviceGroup

类型： DeviceGroup

### deviceGroup 的参数

 * id (ID!)：要获取的设备组的 ID。

## deviceGroups

使用游标分页查找设备组。

路径： team.deviceGroups

类型： DeviceGroupConnection!

### deviceGroups 的参数

 * after (String)：返回指定游标之后的项目。
 * first (Int)：返回列表中的前 n 个项目。
 * orderBy (DeviceGroupOrderBy)：返回的设备组的排序顺序。

## deviceUpgrades

列出一个设备的升级记录。

路径： team.deviceUpgrades

类型： DeviceUpgradeConnection!

### deviceUpgrades 的参数

 * after (String)：返回指定游标之后的项目。
 * filter (DeviceUpgradeFilterInput!)：返回的升级记录的过滤选项。
 * first (Int)：返回列表中的前 n 个项目。
 * orderBy (DeviceUpgradeOrderBy)：返回的升级记录的排序顺序。

## devices

根据条件查找设备。

路径： team.devices

类型： DeviceConnection!

### devices 的参数

 * after (String)：返回指定游标之后的项目。
 * filter (DevicesFilterInput)：返回的设备的过滤选项。
 * first (Int)：返回列表中的前 n 个项目。
 * orderBy (DeviceOrderBy)：返回的设备的排序顺序。

## eventFile

通过 ID 获取一个存储的事件文件。

路径： team.eventFile

类型： EventFile

### eventFile 的参数

 * fileId (ID!)：要获取的事件文件的 ID。

## snap

通过 ID 获取一个事件快照。

路径： team.snap

类型： EventSnap

### snap 的参数

 * snapId (ID!)：要获取的事件快照的 ID。

## snaps

根据条件列出事件快照。

路径： team.snaps

类型： EventSnapConnection!

### snaps 的参数

 * after (String)：返回指定游标之后的项目。
 * filter (EventSnapFilterInput)：返回的快照的过滤选项。
 * first (Int)：返回列表中的前 n 个项目。
 * orderBy (EventSnapOrderBy)：返回的快照的排序顺序。

## snapsExtrasKeyValues

返回匹配快照中一个额外键的观测值。

路径： team.snapsExtrasKeyValues

类型： [String!]!

### snapsExtrasKeyValues 的参数

 * input (SnapsExtrasKeyValuesInput!)：额外索引的搜索选项。
 * key (String!)：要列出其值的额外键。

## snapsExtrasKeys

返回匹配快照中观测到的额外键。

路径： team.snapsExtrasKeys

类型： [String!]!

### snapsExtrasKeys 的参数

 * input (SnapsExtrasKeysInput!)：额外索引的搜索选项。

## snapsTags

返回匹配快照中观测到的标签。

路径： team.snapsTags

类型： [String!]!

### snapsTags 的参数

 * input (SnapsTagsInput!)：标签索引的搜索选项。

## 相关文档

### 模式

检查实时模式端点、SDL 工作流程和自省选项。

[模式](https://docs.luxonis.com/cloud/api/reference/control-api/schema.md)

### 类型

检查控制 API 返回的公开对象和连接类型。

[类型](https://docs.luxonis.com/cloud/api/reference/control-api/types.md)

### 变更

切换到同一 API 接口支持的公开写入操作。

[变更](https://docs.luxonis.com/cloud/api/reference/control-api/mutations.md)

### 关于 GraphQL

返回了解请求结构、身份验证和公开 API 边界。

[关于 GraphQL](https://docs.luxonis.com/cloud/api/graphql.md)
