Версия
v1.0 Beta
Основен URL
/api/v1/
Удостоверяване
Bearer JWT
Формат
JSON / HTML
🔐 Как да се удостоверите
Стъпка 1 — Изпратете POST заявка с вашите данни за достъп, за да получите JWT токен:
POST https://hotel.parsing.eu/api/v1/auth/login/
Content-Type: application/json
{
"email": "your@email.com",
"password": "yourpassword"
}
Стъпка 2 — Добавете access токена в Authorization хедъра на всяка защитена заявка:
# Добавете този хедър към всички защитени заявки:
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
За разглеждане на API в браузъра: натиснете "Log in" горе вдясно на страницата на всеки endpoint и влезте с имейл и парола.
📡 Всички API точки
Удостоверяване
Вход, изход, подновяване на токен, профил
▶
POST
Вход — връща access + refresh JWT токени
🔓 Публичен — не изисква токен
POST
Изход — деактивира refresh токена
🔒 Изисква токен за удостоверяване
POST
Вземи нов access токен с refresh токен
🔓 Публичен — не изисква токен
GET
Профил на текущия потребител и достъпните хотели
🔒 Изисква токен за удостоверяване
POST
Смяна на парола за текущия потребител
🔒 Изисква токен за удостоверяване
GET
Списък с потребители (само за администратор)
🔒 Изисква токен за удостоверяване
GET
Списък с права за достъп до хотели
🔒 Изисква токен за удостоверяване
Основно — Хотели и Периоди
Собственици, хотели, сезони, 10-дневни периоди, туроператори
▶
CRUD
Групи собственици на хотели (GET списък, POST създаване)
🔒 Изисква токен за удостоверяване
CRUD
Хотели — филтрирани според правата ви
🔒 Изисква токен за удостоверяване
CRUD
Сезони по хотел и година (Предварителен/Висок/Извън)
🔒 Изисква токен за удостоверяване
CRUD
10-дневни оперативни периоди (филтър по хотел, година, месец)
🔒 Изисква токен за удостоверяване
CRUD
Туроператори свързани с хотел и ставки на ДДС
🔒 Изисква токен за удостоверяване
Заетост
Дневна заетост на стаи и нощувки, бюджети за заетост
▶
CRUD
Дневна заетост: стаи, нощувки по тип пансион (AI/FB/HB/BB/BO), гости
🔒 Изисква токен за удостоверяване
CRUD
Бюджетни цели за заетост по 10-дневен период
🔒 Изисква токен за удостоверяване
Приходи
Приходи от туроператори и приходи от пакети
▶
CRUD
Приход по туроператор за период: бруто с/без ДДС, нощувки, нето pppd
🔒 Изисква токен за удостоверяване
CRUD
Общ пакетен приход за период: чуждестранен, местен, нето, добавки, pppd спрямо бюджет
🔒 Изисква токен за удостоверяване
Хранене, напитки и допълнителни приходи
Храна, напитки, себестойност, банкети, конференции, наеми
▶
CRUD
Категории Х&Н: Храна / Напитки / Допълнително / Себестойност
🔒 Изисква токен за удостоверяване
CRUD
Х&Н записи за период: сума, нощувки без AI, pppd, спрямо предходна година
🔒 Изисква токен за удостоверяване
CRUD
Допълнителни приходи: Банкет / Конференция / Наем / Друго за период
🔒 Изисква токен за удостоверяване
Персонал
Брой персонал и разходи за заплати по отдел и период
▶
CRUD
Отдели: Рецепция, Хаускийпинг, Ресторант, Барове, Кухня, Анимация, Администрация…
🔒 Изисква токен за удостоверяване
CRUD
Запис за персонал по отдел/период: брой, заплати, спрямо предходна година / последно затваряне
🔒 Изисква токен за удостоверяване
Поддръжка и Комунални услуги
Разходи за поддръжка, вода, ток, нафта, газ
▶
CRUD
Категории поддръжка (тип Поддръжка или Комунална услуга)
🔒 Изисква токен за удостоверяване
CRUD
Записи за разходи по поддръжка за период: сума, pppd, спрямо предходна година
🔒 Изисква токен за удостоверяване
CRUD
Консумация: Вода (м³), Ток (kWh), Нафта (л), Газ — количество, единична цена, общо
🔒 Изисква токен за удостоверяване
Бюджет
Приходни и разходни бюджетни цели за период (Оперативен vs Оригинален)
▶
CRUD
Приходен бюджет: пакет бруто/нето, pppd, допълнителни приходи, общо
🔒 Изисква токен за удостоверяване
CRUD
Разходен бюджет: Х&Н, персонал, поддръжка, комунални услуги, общо
🔒 Изисква токен за удостоверяване
Отчети
Обобщени оперативни отчети по периоди
▶
GET
Резюме на период: всички KPI обобщени — заетост, приходи, разходи за хотел/година/месец
🔒 Изисква токен за удостоверяване
GET
Месечна статистика на заетостта: стаи, нощувки по тип, гости
🔒 Изисква токен за удостоверяване