# Acceso a los elementos

Los elementos son datos individuales de la base de datos. Pueden ser cualquier cosa, desde artículos hasta comprobaciones de estado de IoT.

## **El objeto Item**

Los elementos tienen un esquema predefinido. El formato depende completamente de los datos y estructuras definidas.

> Datos relacionales
> 
> De forma predeterminada, el objeto item no contiene datos relacionales anidados. Para recuperar datos anidados, consulte Datos relacionales y parámetros de campo.

## **Obtener items**

Enumera todos los elementos que existen en la colección definida.

**Request**

```
GET /items/:collection

SEARCH /items/:collection

```

<div class="snippet-clipboard-content notranslate position-relative overflow-auto" id="bkmrk-"><div class="zeroclipboard-container"><svg aria-hidden="true" class="octicon octicon-copy js-clipboard-copy-icon" data-view-component="true" height="16" version="1.1" viewbox="0 0 16 16" width="16"></svg></div></div>Si utiliza SEARCH, puede proporcionar un objeto de consulta como cuerpo de la solicitud. Más información sobre [SEARCH](https://github.com/ogticrd/catalogo-servicios-doc/blob/main/README.md#m%C3%A9todo-http-search).

**Parámetros de consulta**

Admite todos los parámetros de consulta globales.

> Datos relacionales
> 
> El parámetro Field es necesario para devolver datos relacionales anidados.

**Respuesta**

Matriz de objetos de elemento hasta límite. Si no hay elementos disponibles, los datos serán una matriz vacía.

**Ejemplo**

```
SEARCH /items/services
```

## **Obtener item por ID**

Obtén un elemento que exista en la colección definida.

**Request**

```
GET /items/:collection/:id

```

<div class="snippet-clipboard-content notranslate position-relative overflow-auto" id="bkmrk--1"><div class="zeroclipboard-container"><svg aria-hidden="true" class="octicon octicon-copy js-clipboard-copy-icon" data-view-component="true" height="16" version="1.1" viewbox="0 0 16 16" width="16"></svg></div></div>**Parámetros de consulta**

Admite todos los parámetros de consulta globales.

**Respuesta**

Devuelve un objeto de elemento si se proporcionó una clave principal válida.

**Ejemplo**

```
GET /items/services/15
```