Superhostem.cz
Superhostem API v1

Документація публічного API

Використовуйте API-токен власника, щоб запускати вибрані автоматизації Superhostem зі свого бекенду або внутрішніх інструментів.

Створити акаунтКерувати API-токенами
POST
/api/v1/calendars/sync
curl -X POST 'https://www.superhostem.cz/api/v1/calendars/sync' \
  -H 'x-api-key: sht_YOUR_TOKEN'
200

Усі календарі успішно синхронізовано.

207

Деякі календарі не синхронізувалися; перевірте масив results.

401

Токен відсутній, прострочений, відкликаний або недійсний.

Як отримати персональний API-токен

  1. 1Увійдіть у Superhostem під акаунтом власника, якому має належати інтеграція.
  2. 2Відкрийте Dashboard -> Settings -> Profile і знайдіть секцію API tokens.
  3. 3Створіть токен, одразу скопіюйте його та збережіть у сховищі secrets на сервері або в автоматизації.
Відкрити налаштування API-токенів

Кінцева точка

Метод
POST
Кінцева точка
/api/v1/calendars/sync
Тіло запиту
JSON body не потрібен.

Відповідь

{
  "ok": true,
  "syncedCalendars": 3,
  "propertiesChecked": 2,
  "failed": 0,
  "durationMs": 1842,
  "results": [
    {
      "propertyId": "...",
      "propertyName": "Апартаменти Прага",
      "source": "airbnb",
      "ok": true,
      "result": {
        "status": "success",
        "reservationsFound": 4,
        "reservationsCreated": 1,
        "reservationsUpdated": 3,
        "reservationsCancelled": 0
      }
    }
  ]
}

JavaScript

const response = await fetch('https://www.superhostem.cz/api/v1/calendars/sync', {
  method: 'POST',
  headers: {
    'x-api-key': 'sht_YOUR_TOKEN',
  },
});

const result = await response.json();
console.log(result);