# CameraRent.cz

> P2P tržiště foto, video a dron techniky v České republice. Jednotlivci si půjčují techniku mezi sebou. Platby a kauce probíhají mimo platformu.

## Co platforma dělá

- Uživatelé vkládají nabídky techniky (fotoaparáty, objektivy, drony, světla, stativy, audio…)
- Zájemci posílají poptávky; po schválení pronajímatelem se otevře chat
- Ceny jsou v Kč/den; kauce je orientační, domlouvá se při předání
- AI pomáhá při vkládání techniky (parametry, popis) — orientační, ne závazné

## Veřejné API (read-only)

Discovery: https://camerarent.cz/api/v1
OpenAPI: https://camerarent.cz/openapi/v1.yaml

### Endpointy

| Endpoint | Popis |
|----------|-------|
| GET https://camerarent.cz/api/v1/listings | Vyhledávání techniky |
| GET https://camerarent.cz/api/v1/listings/{id} | Detail inzerátu |
| GET https://camerarent.cz/api/v1/listings/{id}/availability | Zablokované termíny |
| GET https://camerarent.cz/api/v1/listings/suggest?q= | Rychlý našeptávač (max 8) |
| GET https://camerarent.cz/api/v1/categories | Kategorie techniky |
| GET https://camerarent.cz/api/v1/users/{id} | Veřejný profil pronajímatele |

### Filtry pro /api/v1/listings

- `q` — hledání v názvu a modelu (min. 2 znaky)
- `kategorie` — slug kategorie, např. `fotoaparaty`, `objektivy`, `drony`
- `kraj` — jeden z 14 krajů ČR (Praha, Středočeský, Jihomoravský, …)
- `sort` — `nejnovejsi` | `nejlevnejsi` | `nejdrazsi`
- `page`, `limit` — stránkování (limit max 100)

### Formát odpovědi

```json
{ "data": [...], "meta": { "page": 1, "limit": 20, "total": 42 } }
```

Chyby: `{ "error": "popis chyby" }` s HTTP status kódem.

## Co API neumí (zatím)

- Přihlášení / API tokeny — poptávky a chat jen přes web s účtem
- Vytváření nebo úprava inzerátů
- Platby a kauce

## Odkazy pro lidi

- Nabídka techniky: https://camerarent.cz/technika
- Detail inzerátu: https://camerarent.cz/technika/{id}
- Profil uživatele: https://camerarent.cz/uzivatel/{id}
- Registrace: https://camerarent.cz/registrace