# API Parquetecmar (Angra)

O portal **Parquetecmar** (projeto em `www/pmar/parquetecmar`) consome os dados de Editais e Decretos/Leis via API do Angra.

**Base URL da API:** `https://angra.rj.gov.br/api` (em desenvolvimento: `http://127.0.0.1:8000/api`)

---

## Editais

| Método | Endpoint | Uso |
|--------|----------|-----|
| GET | `/api/parquetecmar/editais?limit=6` | Lista para a **home** (ex.: 6 itens) |
| GET | `/api/parquetecmar/editais?page=1&per_page=12` | Lista paginada (**Ver Todos**) |
| GET | `/api/parquetecmar/editais/{slug}` | **Detalhe** de um edital |
| GET | `/api/parquetecmar/editais/{slug}/download` | **Download** do arquivo (PDF/documento) |

### Exemplo resposta – lista (home)

```json
{
  "data": [
    {
      "id": "uuid",
      "titulo": "Chamada Pública N° 004/2025/SPG...",
      "slug": "chamada-publica-004-2025-spg",
      "descricao": "Texto completo...",
      "descricao_resumo": "Texto limitado a 160 caracteres...",
      "data_publicacao": "2025-02-01",
      "data_publicacao_formatada": "01/02/2025",
      "tem_arquivo": true,
      "arquivo_url": "https://angra.rj.gov.br/api/parquetecmar/editais/{slug}/download",
      "url": "https://parquetecmar.angra.rj.gov.br/editais/{slug}"
    }
  ]
}
```

### Exemplo resposta – lista paginada

```json
{
  "data": [ ... ],
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 12,
    "total": 28
  }
}
```

### Exemplo resposta – detalhe

Mesmos campos do item da lista, sem array (objeto único).

---

## Decretos e Leis

| Método | Endpoint | Uso |
|--------|----------|-----|
| GET | `/api/parquetecmar/decretos-leis?limit=6` | Lista para a **home** |
| GET | `/api/parquetecmar/decretos-leis?page=1&per_page=12` | Lista paginada |
| GET | `/api/parquetecmar/decretos-leis/{slug}` | **Detalhe** |
| GET | `/api/parquetecmar/decretos-leis/{slug}/download` | **Download** do arquivo |

Estrutura igual à de Editais; em cada item há ainda o campo `numero_lei` (string).

---

## Configuração no Angra

No `.env` do Angra (opcional), para montar os links `url` nas respostas:

```env
PARQUETECMAR_URL=https://parquetecmar.angra.rj.gov.br
```

Se não for definido, usa-se `https://parquetecmar.angra.rj.gov.br` por padrão.

---

## Uso no projeto Parquetecmar

- **Home:** chamar `GET /api/parquetecmar/editais?limit=6` e `GET /api/parquetecmar/decretos-leis?limit=6` e exibir as sections com os cards; link "Ver Todos" → página que usa a lista paginada.
- **Página Ver Todos (Editais):** `GET /api/parquetecmar/editais?page=1&per_page=12`.
- **Página de detalhe (Edital):** `GET /api/parquetecmar/editais/{slug}`; botão "Baixar arquivo" → `arquivo_url` (ou `/api/parquetecmar/editais/{slug}/download`).
- O mesmo vale para Decretos e Leis, trocando `editais` por `decretos-leis` e a URL do portal por `/decretos-e-leis/{slug}`.