REST API

Интегрирайте вашата система с REST API

Получете пълен достъп до данните за резервации, гости и стаи чрез нашия REST API. Автоматизирайте процесите и интегрирайте mobile-calendar със собствените си системи.

GET /v1/public/reservations
Authorization: Bearer {access_token}

{
  "data": {
    "reservationId": 478652,
    "roomId": 28568,
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "clientId": 362792
  },
  "meta": {
    "ruid": "7f80f1b4-a44b-4345-b383-7d0a937b4411"
  }
}
Възможности

Цялостен API за Вашия бизнес

Нашият REST API осигурява пълен достъп до всички функции на системата, позволявайки създаването на персонализирани интеграции и автоматизация.

CRUD операции

Пълен контрол върху данните - създаване, четене, актуализация и изтриване на записи чрез стандартни HTTP заявки.

  • Управление на резервации
  • Данни на госта
  • Конфигурация на стая
  • Фактури и плащания
Уеб куки В реално време

Получавайте мигновени известия за промените в системата директно на вашия сървър.

  • Известия в реално време
  • Конфигурируем обхват на събитие
  • Сигурна HTTPS връзка
  • Автоматични повторения
Панел за логове на разработчика

Следете всички API заявки и отстранявайте грешки в интеграциите директно в приложението.

  • История на заявките към API
  • Пълни отговори на сървъра
  • Детайли за грешка
  • 30-дневна история
Крайни точки

Достъп до всички данни

API предоставя крайни точки за всички ключови ресурси на системата. Подробна документация с примери е достъпна онлайн.

Преглед на документацията
  • /reservations

    Изтегляне, създаване и промяна на резервации. Достъп до пълна история и статуси.

  • /guests

    Управление на базата данни за гости, информация за контакт и история на престоя.

  • /rooms

    Конфигуриране на стаи, наличности, цени и удобства функции.

  • /invoices

    Генерирайте фактури, следете плащания и управлявайте документи.

POST Webhook Event
{
  "webhookId": "9b9b499e-095c-4955-8dd0-cc5d84e50764",
  "eventType": "reservation.created",
  "timestamp": "2025-10-10T15:39:07+02:00",
  "data": {
    "type": "SINGLE",
    "reservationId": [478652],
    "roomId": [28568],
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "clientId": 362792,
    "triggeredBy": "MANUAL"
  }
}
Webhooks

Известия в реално време

Уебхуковете позволяват автоматични реакции на събития в системата. Конфигурирайте URL на крайна точка и получавайте известия за нови резервации, промени и анулирания.

  • reservation.created - нова резервация
  • reservation.updated - модификация на резервацията
  • reservation.cancelled - анулиране на резервация
  • reservation.checked_in - регистрация на госта
Научете повече за webhooks

REST API е наличен в Premium плана

Достъпът до REST API, webhooks и панела с журналите за разработчици е част от Premium плана. Получете пълен контрол над интеграциите на вашия имот.

REST API FAQ

Често задавани въпроси

Не намерихте това, което търсихте? Проверете в центъра за помощ или се свържете с нас.

Достъпът до REST API е автоматично активиран за потребители на Premium плана. Можете да генерирате API ключ в настройките на акаунта под секцията „Интеграции“.
Всички заявки изискват Authorization header с Bearer token. Подробности за удостоверяване могат да бъдат намерени в документацията на API.
Да, приложен е лимит от 60 заявки на минута. Ако имате по-големи нужди, свържете се с нас.
Отидете в настройките на account, секция "Webhooks", добавете URL на крайна точка и изберете събитията, за които искате да получите уведомление. Системата автоматично ще изпрати POST уведомление до предоставения адрес.
API документацията съдържа подробни описания на всички крайни точки с примери. Освен това, нашият технически екип за поддръжка е на разположение чрез чат и имейл.