# Consultar fotos

> Busca registros de fotos por id, lista de ids ou nome de arquivo.

Fonte: https://api.viashopmoda.com.br/docs-api/?p=recursos/fotos/consultar · Atualizado em 18/11/2026


## O que faz

Consulta fotos cadastradas. Para ver as fotos de um produto, normalmente basta [`produto/consultar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/produto/consultar&formato=md), que já traz a lista.

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/fotos/consultar/{TOKEN}` |
| **Corpo** | Nenhum. Filtros vão na query string (`?campo=valor&...`). |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |


## Parâmetros

Todos os parâmetros são opcionais e vão na query string. Use um filtro por vez, salvo quando a descrição disser para combinar.

| Parâmetro | Descrição |
|---|---|
| `id` | Id da foto. |
| `in_ids` | Vários ids separados por vírgula (mantém a ordem). |
| `arquivo` | Nome do arquivo na loja. |
| `arquivo_original` | Parte do caminho da URL original enviada no upload. |


## Regras

- Sem filtro, a resposta vem vazia (`"fotos": ""`).
- `in_ids` devolve na mesma ordem da lista enviada.

## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/fotos/consultar/SEU_TOKEN?in_ids=101,102"
```

Resposta: `{"fotos": [ { ... }, { ... } ]}`.

## Pode reenviar?

Sim (somente leitura).
