# Oratrix API - Galeria

## Status

Documentacao parcial baseada na parte enviada para o projeto Wezapp Shots.

Este grupo trata arquivos de galeria do Oratrix. Para o Wezapp Shots, pode ser util quando campanhas precisarem enviar midias recorrentes, mas nao deve substituir o controle interno de assets da campanha caso o Wezapp venha a ter esse modulo.

## Base URL

```text
https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}
```

## Autenticacao

```http
Authorization: Bearer {token}
```

## Endpoints do grupo

Total documentado nesta parte: 3 endpoints.

---

## 1. Listar arquivos da galeria

```http
GET /gallery/list
```

Nome na documentacao Oratrix:

```text
GalleryList
```

Descricao:

Listar arquivos da galeria.

---

## 2. Upload de arquivo para galeria

```http
POST /gallery/upload
```

Nome na documentacao Oratrix:

```text
GalleryUpload
```

Descricao:

Fazer upload de arquivo(s) para a galeria.

Limites informados:

- Maximo de 10 arquivos
- Ate 500MB

URL completa:

```text
https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}/gallery/upload
```

Body:

```text
Form Data
```

Campos:

| Campo | Tipo | Obrigatorio | Descricao |
|---|---|---:|---|
| files | file | Sim | Arquivo(s), ate 10 arquivos |

---

## 3. Excluir arquivo da galeria

```http
POST /gallery/delete/:id
```

Nome na documentacao Oratrix:

```text
GalleryDelete
```

Descricao:

Excluir um arquivo da galeria pelo ID.

URL completa:

```text
https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}/gallery/delete/:id
```

Body JSON:

```json
{}
```

## Mapeamento sugerido com Wezapp Shots

| Wezapp Shots | Oratrix |
|---|---|
| Midia de campanha futura | Arquivo na galeria Oratrix |
| Asset interno do Wezapp | Referencia externa da galeria |
| Envio com media | Possivel uso combinado com endpoints de disparo |

## Pendencias tecnicas para validar

- Confirmar formato de retorno de `/gallery/list`.
- Confirmar se `/gallery/upload` retorna IDs dos arquivos.
- Confirmar formatos de arquivo aceitos.
- Confirmar se o limite de 500MB e por arquivo ou total da requisicao.
- Confirmar se arquivos enviados para galeria podem ser usados diretamente nos endpoints de envio.
- Confirmar se ha URL publica, URL assinada ou apenas ID interno.

## Regras recomendadas para o Wezapp Shots

1. Nao enviar arquivos grandes sem validacao previa.
2. Registrar auditoria em upload e exclusao de arquivos.
3. Guardar referencia externa da midia quando usada em campanha.
4. Evitar depender da galeria externa como unico armazenamento de midias importantes.