Superhostem.cz
Superhostem API v1

Dokumentace veřejného API

Použijte API token vlastníka ke spuštění vybraných automatizací Superhostem z vlastního backendu nebo interního nástroje.

Vytvořit účetSpravovat API tokeny
POST
/api/v1/calendars/sync
curl -X POST 'https://www.superhostem.cz//api/v1/calendars/sync' \
  -H 'x-api-key: sht_YOUR_TOKEN'
200

Všechny kalendáře byly synchronizovány úspěšně.

207

Některé kalendáře selhaly; zkontrolujte pole results.

401

Chybějící, expirovaný, zrušený nebo neplatný token.

Jak získat osobní API token

  1. 1Přihlaste se do Superhostem účtem vlastníka, kterému má integrace patřit.
  2. 2Otevřete Dashboard -> Nastavení -> Profil a najděte sekci API tokeny.
  3. 3Vytvořte token, hned ho zkopírujte a uložte do secrets na serveru nebo ve své automatizaci.
Otevřít nastavení API tokenů

Endpoint

Metoda
POST
Endpoint
/api/v1/calendars/sync
Body
Není potřeba žádné JSON body.

Odpověď

{
  "ok": true,
  "syncedCalendars": 3,
  "propertiesChecked": 2,
  "failed": 0,
  "durationMs": 1842,
  "results": [
    {
      "propertyId": "...",
      "propertyName": "Apartment Prague",
      "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);