[comment]: # translation:outdated

[comment]: # ({554f8ab9-554f8ab9})
# image.get

[comment]: # ({/554f8ab9-554f8ab9})

[comment]: # ({40e42340-ef6436a6})
### Descrição

`integer/array image.get(object parameters)`

O método permite recuperar imagens de acordo com os parâmetros fornecidos.

::: noteclassic
Este método está disponível para usuários de qualquer tipo. Permissões
para chamar o método pode ser revogado nas configurações de função do usuário. Veja [Usuário
funções](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

[comment]: # ({/40e42340-ef6436a6})

[comment]: # ({96449e0d-ac7ee93f})
### Parâmetros

`(object)` Parâmetros que definem a saída desejada.

O método oferece suporte aos seguintes parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|---------|----------------------------------- ------------|-----------|
|imageids|string/array|Retorna apenas imagens com os IDs fornecidos.|
|sysmapids|string/array|Retorna imagens que são usadas nos mapas fornecidos.|
|select\_image|flag|Retorne uma propriedade `image` com a imagem codificada em Base64.|
|sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `imageid` e `name`.|
|countOutput|boolean|Estes parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).|
|editável|booleano|^|
|excludePesquisa|boolean|^|
|filtro|objeto|^|
|limite|inteiro|^|
|saída|consulta|^|
|preservekeys|boolean|^|
|pesquisar|objeto|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|ordem de classificação|cadeia/matriz|^|
|startSearch|boolean|^|

[comment]: # ({/96449e0d-ac7ee93f})

[comment]: # ({7223bab1-7223bab1})
### Valores de retorno

`(integer/array)` Retorna:

- uma matriz de objetos;
- a contagem de objetos recuperados, se o parâmetro `countOutput` tiver
    sido usado.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({a74f608e-d6cd6c58})
#### Recuperar uma imagem

Recupere todos os dados da imagem com ID "2".

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "imagem.get",
    "parâmetros": {
        "saída": "estender",
        "select_image": verdadeiro,
        "imageids": "2"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": [
        {
            "imagemid": "2",
            "tipo de imagem": "1",
            "name": "Cloud_(24)",
            "Imagem": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s + N5j9BIMEf4Hg / jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4 / OB7 + V0OAgC0UyDENFEU03rh1uNOs / lFG75o2i2 / rkd9Y3Tgyj3HiaezbukdH9A / rP4E9vWi0u + Y4fuGnMf3DRgYc3Z / 84YrQSkD3mgKhFAC + KAEK74Y2Lj3MjPoOokQ3Xyx / 1GHeXCifbfO6lRPH / wi + AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5 / WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y / cfAENmHZF4XrY9Mc + X9HAFmoyXS2ddy1IOg6 / KNyBcM0DFP / wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t / ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg / msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW / V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r + cn7Jc8c2eWrbM6Wbe6 /aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAASUVORK5CYII="
        }
    ],
    "id": 1
}
```

[comment]: # ({/a74f608e-d6cd6c58})

[comment]: # ({ade21c34-ade21c34})
### Fonte

CImage::get() em *ui/include/classes/api/services/CImage.php*.

[comment]: # ({/ade21c34-ade21c34})