Version
v1.0 Beta
Base URL
/api/v1/
Authentication
Bearer JWT
Format
JSON / HTML
π How to Authenticate
Step 1 β Send a POST request with your credentials to get a JWT token pair:
POST https://hotel.parsing.eu/api/v1/auth/login/
Content-Type: application/json
{
"email": "your@email.com",
"password": "yourpassword"
}
Step 2 β Include the access token in the Authorization header of every request:
# Add this header to all protected requests:
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
To browse the API in the browser: click "Log in" at the top-right corner of any endpoint page and sign in with your email and password.
π‘ All API Endpoints
Authentication
Login, logout, token refresh, user profile
βΆ
POST
Login β returns access + refresh JWT tokens
π Public β no token required
POST
Logout β blacklists the refresh token
π Requires authentication token
POST
Get a new access token using a refresh token
π Public β no token required
GET
Get current user profile and accessible hotels
π Requires authentication token
POST
Change password for the current user
π Requires authentication token
GET
List all users (admin only)
π Requires authentication token
GET
List hotel access permissions
π Requires authentication token
Core β Hotels & Periods
Hotel owners, hotels, seasons, 10-day periods, tour operators
βΆ
CRUD
Hotel owner groups (GET list, POST create)
π Requires authentication token
CRUD
Hotels β filtered by your access permissions
π Requires authentication token
CRUD
Season definitions per hotel and year (Pre/High/Off)
π Requires authentication token
CRUD
10-day operational periods (filter by hotel, year, month)
π Requires authentication token
CRUD
Tour operators linked to each hotel with VAT rates
π Requires authentication token
Occupancy
Daily room and bednight occupancy, occupancy budgets
βΆ
CRUD
Daily occupancy: rooms occupied, bednights by board type (AI/FB/HB/BB/BO), guests
π Requires authentication token
CRUD
Occupancy budget targets per 10-day period
π Requires authentication token
Revenues
Tour operator revenues and package (arrangement) revenues
βΆ
CRUD
Revenue per tour operator per period: gross with/without VAT, bednights, net pppd
π Requires authentication token
CRUD
Total package revenue per period: foreign, local, net, supplement, pppd vs budget
π Requires authentication token
F&B & Extra Revenue
Food, beverage, cost of sales, banquets, conferences, rentals
βΆ
CRUD
F&B categories: Food / Beverage / Extra / Cost of Sales
π Requires authentication token
CRUD
F&B entries per period: amount, non-AI bednights, pppd, vs previous year
π Requires authentication token
CRUD
Extra revenue: Banquet / Conference / Rental / Other per period
π Requires authentication token
Staff
Department headcount and salary costs per period
βΆ
CRUD
Departments: Front Office, Housekeeping, Restaurant, Bars, Kitchen, Animation, Adminβ¦
π Requires authentication token
CRUD
Staff entry per department/period: headcount, salary, vs previous year / last closure
π Requires authentication token
Maintenance & Utilities
Maintenance costs, water, electricity, oil, gas consumption
βΆ
CRUD
Maintenance categories (Maintenance or Utility type)
π Requires authentication token
CRUD
Maintenance cost entries per period: amount, pppd, vs previous year
π Requires authentication token
CRUD
Utility consumption: Water (mΒ³), Electricity (kWh), Oil (L), Gas β quantity, unit price, total
π Requires authentication token
Budget
Revenue and cost budget targets per period (Operational vs Original)
βΆ
CRUD
Revenue budget: package gross/net, pppd, extra revenue, total revenue
π Requires authentication token
CRUD
Cost budget: F&B, staff, maintenance, utilities, total cost
π Requires authentication token
Reports
Aggregated operational reports across periods
βΆ
GET
Period summary: all KPIs aggregated β occupancy, revenues, costs for hotel/year/month
π Requires authentication token
GET
Monthly occupancy statistics: rooms, bednights by board type, guests
π Requires authentication token