sass-imobiliaria/.specify/features/007-admin-panel/contracts/properties.md

81 lines
1 KiB
Markdown

# Contract: Admin Properties Endpoints
**Prefix:** `/api/v1/admin/properties`
**Auth:** JWT Bearer (admin)
---
## GET /api/v1/admin/properties
Lista todos os imóveis cadastrados.
### Response 200
```json
[
{
"id": "uuid",
"title": "Casa 1",
"address": "Rua X, 123",
"price": 500000.00,
"status": "ativo"
}
]
```
---
## POST /api/v1/admin/properties
Cria um novo imóvel.
### Request
```json
{
"title": "Casa 1",
"address": "Rua X, 123",
"price": 500000.00,
"status": "ativo"
}
```
### Response 201
```json
{
"id": "uuid",
"title": "Casa 1",
"address": "Rua X, 123",
"price": 500000.00,
"status": "ativo"
}
```
---
## PUT /api/v1/admin/properties/:id
Atualiza um imóvel existente.
### Request
```json
{
"title": "Casa 1",
"address": "Rua X, 123",
"price": 500000.00,
"status": "ativo"
}
```
### Response 200
```json
{
"id": "uuid",
"title": "Casa 1",
"address": "Rua X, 123",
"price": 500000.00,
"status": "ativo"
}
```
---
## DELETE /api/v1/admin/properties/:id
Remove um imóvel.
### Response 204