7. API — Visão Arquitetural

Os endpoints abaixo representam a proposta inicial e poderão ser ajustados durante a implementação.

As requisições que não enviam arquivos usarão application/json. O cadastro de item com fotografia usará multipart/form-data, com os campos do item e o arquivo enviados na mesma requisição.

Usuários

POST /api/usuarios
POST /api/auth/login
POST /api/auth/logout
GET  /api/usuarios/me
PUT  /api/usuarios/me

Itens

POST   /api/itens
GET    /api/itens
GET    /api/itens/{id}
PUT    /api/itens/{id}
DELETE /api/itens/{id}

Busca

GET /api/busca
GET /api/itens?categoria=
GET /api/itens?localizacao=
GET /api/itens?data=

Match

GET  /api/matches
GET  /api/matches/{id}
POST /api/matches/{id}/confirmar
POST /api/matches/{id}/recusar

Postos

GET /api/postos
GET /api/postos/{id}

Recompensas

GET /api/recompensas
GET /api/recompensas/pontos

---