Kompletní interaktivní dokumentace API je dostupná přes Swagger:
Otevřít Swagger UI — plná interaktivní dokumentace s možností testování endpointů
| Base URL | https://brinks.techcrowd.space/AiApi |
| Autentizace | Bearer token |
| Formát | JSON |
| Content-Type | application/json |
| Swagger | swagger/index.html |
POST /access
Body: { "email": "...", "password": "..." }
Response: { "token": "bearer-token..." }
Všechny další requesty musí obsahovat header:
Authorization: Bearer <token>
GET /organisations # Seznam organizací
GET /service-locations # Servisní lokace
GET /banks # Banky
GET /sale-types # Typy prodeje
GET /sale-parameters # Parametry prodeje
GET /price-lists # Seznam cenových souborů
POST /price-lists # Vytvoření nového
GET /price-lists/{id} # Detail
PUT /price-lists/{id} # Aktualizace
DELETE /price-lists/{id} # Smazání (jen Draft)
POST /price-lists/import # Import XLSX
GET /location-billing-policies # Seznam
POST /location-billing-policies # Vytvoření
PUT /location-billing-policies/{id} # Aktualizace
DELETE /location-billing-policies/{id} # Smazání
GET /transactions # Seznam (filtry: date_from, date_to, quality, type)
GET /transactions/{id} # Detail s billing kalkulací
GET /billing-periods # Fakturační období
POST /billing-periods/{id}/generate # Generování faktury
GET /invoices # Seznam faktur
GET /invoices/{id} # Detail faktury
GET /reports/dashboard # KPI data
GET /reports/export # Export (CSV/XLSX/PDF)
{
"message": "Popis chyby",
"errors": {
"field_name": ["Validační chyba"]
}
}
| HTTP kód | Význam |
|---|---|
| 401 | Neautorizováno — neplatný nebo expirovaný token |
| 403 | Zakázáno — nedostatečná práva |
| 404 | Nenalezeno |
| 422 | Validační chyba |
| 500 | Server error |
Tip: Pro detailní popis všech modelů, parametrů a response schémat použijte Swagger UI.