Dla salonu, który łączy swoje narzędzia

API dla salonu: Twoje wizyty i klientki tam, gdzie ich potrzebujesz

Księgowa prosi o zestawienie wizyt z miesiąca, program do newslettera czeka na nowe klientki, a strona www ma zapisywać prosto do kalendarza. Zamiast przepisywać dane ręcznie, tworzysz w Slotorze klucz, wklejasz go do narzędzia i decydujesz, co wolno mu zobaczyć. Do Zapiera i Make nie potrzebujesz programisty, a za połączenia nic nie płacisz.

0 zł miesięcznie · 0% prowizji · płatne osobno: SMS-y, Nita i recepcjonistka telefoniczna AI

Załóż konto w Slotorze

Co salony najczęściej podłączają

Interfejs działa od 11 października 2026 roku. Poniżej cztery zastosowania, od których zaczyna większość właścicielek — każde ustawisz w jedno popołudnie.

Zapier: każda nowa wizyta w Arkuszach Google

Wyzwalacz „Catch Hook” odbiera wiadomość o rezerwacji i dopisuje wiersz do arkusza albo wysyła powiadomienie do kanału zespołu na Slacku.

Make: scenariusz według własnego pomysłu

Moduł „Custom webhook” reaguje na zmiany, a moduł HTTP pobiera wizyty i klientki według harmonogramu, na przykład co noc o drugiej.

Program do newslettera

Nowe klientki trafiają na listę mailingową razem z informacją, czy zrezygnowały z wiadomości marketingowych. Te osoby narzędzie musi pominąć.

Własna strona salonu

Strona pobiera wolne godziny i zapisuje wizytę tą samą drogą co recepcja, więc nie powstanie rezerwacja, której kalendarz by nie przyjął.

Jeden klucz na jedno narzędzie

Klucz zakłada właścicielka albo administratorka salonu, w przeglądarce, w Ustawieniach → API i webhooki. Widać go tylko raz, w chwili utworzenia; my przechowujemy jedynie jego odcisk, więc nikt go później nie odczyta, łącznie z nami. Przy każdym kluczu zaznaczasz, na co pozwala.

Uprawnienia klucza API w Slotorze i to, co każde z nich otwiera
Uprawnienie	Co otwiera	Na start
Czytanie wizyt	Wizyty z imieniem klientki, usługą, osobą z zespołu, ceną i wpłatami, a także wolne godziny	zaznaczone
Czytanie klientów	Imię, telefon, e-mail, język i zgoda marketingowa; nigdy notatki	zaznaczone
Czytanie usług i zespołu	Cennik z czasem trwania, lista osób i lokali salonu	zaznaczone
Rezerwowanie wizyt	Zapis na termin, który salon sam oferuje	odznaczone

Salon może mieć jednocześnie dwadzieścia działających kluczy i dziesięć adresów webhooków. Klucz przestaje działać sam, gdy osoba, która go utworzyła, przestaje zarządzać salonem.

Uczciwie: czego API dziś nie robi

Nie ma aplikacji Slotory w katalogu Zapiera ani Make: Łączysz się uniwersalnymi modułami webhooków i zapytań HTTP. Działają tak samo, ale pola mapujesz sama, a nie z gotowej listy.
Przewodnik dla programistów jest po angielsku: Ekran ustawień i ta strona są po polsku, ale szczegółowa dokumentacja techniczna istnieje dziś tylko w języku angielskim.
Webhook nie przychodzi w tej samej sekundzie: Zmiany zbieramy co kwadrans. Do arkusza czy newslettera to wystarcza, ale do natychmiastowego powiadamiania przy każdej rezerwacji lepsze są powiadomienia w aplikacji Slotora.
API nie łączy się z kasą fiskalną: Slotora nie jest kasą fiskalną i niczego do kasy nie wysyła. Usługę rejestrujesz na swojej kasie jak dotąd, a faktury przez Fakturownię opisujemy na osobnej stronie.

Dla osoby, która pisze kod

Adres bazowy to https://slotora.io/api/v1, odpowiedzi przychodzą w JSON-ie, a klucz wysyłasz w nagłówku Authorization jako Bearer albo w nagłówku X-Api-Key — nigdy w adresie. Pełny opis w formacie OpenAPI leży pod /api/v1/openapi.json, więc da się z niego wygenerować klienta w dowolnym języku.

Godziny wracają w strefie czasowej salonu, z przesunięciem, na przykład 2026-11-20T10:00:00+01:00 dla zimowego czasu w Warszawie. Dzięki temu arkusz księgowej pokazuje tę samą godzinę co kalendarz, bez przeliczania z czasu uniwersalnego.

Listy przychodzą stronami po najwyżej sto pozycji, a pole nextCursor prowadzi do kolejnej strony. Wizyty bez filtrów obejmują dziś i trzydzieści jeden kolejnych dni; zakres możesz ustawić sam, maksymalnie na rok z jednym dniem zapasu.

Jeden klucz wykona sto dwadzieścia zapytań na minutę. Powyżej limitu dostaje kod 429 z nagłówkiem Retry-After, a każde zapytanie zostaje w dzienniku salonu przez trzydzieści dni.

Rezerwacja przez API przechodzi przez ten sam kod co zapis w recepcji: termin musi być wolny, stanowiska i gabinety są sprawdzane, a klientka dostaje Twoje zwykłe potwierdzenie. Z nagłówkiem Idempotency-Key ponowione w ciągu pięciu minut żądanie zwraca już utworzoną wizytę zamiast drugiej.

Webhooki: Slotora sama daje znać o zmianie

Pięć zdarzeń: nowa wizyta, zmiana wizyty, odwołanie, nowa klientka i przyjęta płatność. Slotora sprawdza zmiany co kwadrans, więc wiadomość dociera zwykle w ciągu piętnastu minut.

Adres
Wklejasz adres z Zapiera albo Make
Adres musi zaczynać się od https:// i być dostępny w internecie. Przekierowań nie wykonujemy, a narzędzie ma dziesięć sekund na odpowiedź.
Test
Przycisk „Wyślij test” zamiast prawdziwej klientki
Wysyłamy jedną podpisaną wiadomość z przykładowymi danymi. Zapier czy Make uczą się z niej pól, a dane prawdziwych osób nie wychodzą poza salon przy konfiguracji.
Podpis
Każda wiadomość niesie podpis
Nagłówek Slotora-Signature zawiera czas i podpis HMAC-SHA256 liczony sekretem, który zobaczysz raz, przy dodaniu adresu. Własny serwer powinien go sprawdzać; Zapier i Make tego nie wymagają.
Ponowienia
Gdy narzędzie nie odbiera
Próbujemy ponownie po minucie, po pięciu i trzydziestu minutach, potem po dwóch, sześciu, dwunastu i dwudziestu czterech godzinach — razem osiem prób. Po piętnastu porażkach z rzędu albo trzech dniach samych błędów adres zostaje wyłączony, a właścicielka dostaje powiadomienie.

Dane klientek, RODO i to, co nigdy nie wychodzi

Notatki — przy klientce, przy wizycie i czerwone ostrzeżenie — nie pojawiają się ani w odpowiedzi API, ani w webhooku. Adresów, dat urodzenia, tagów, punktów lojalnościowych i wynagrodzeń zespołu interfejs w ogóle nie zna.

Jeśli ukrywasz telefony i maile klientek przed zespołem, API również je ukrywa: pola wracają puste, oznaczone jako ukryte, żeby narzędzie odróżniło brak danych od ich zasłonięcia.

Pamiętaj, że to Ty decydujesz, dokąd dane trafiają. Zewnętrzne narzędzie, któremu dajesz klucz, przetwarza dane Twoich klientek w Twoim imieniu, więc sprawdź jego warunki i umowę powierzenia, zanim podłączysz kartotekę. Daj mu tylko te uprawnienia, których naprawdę potrzebuje.

Pytania o API i webhooki

Ile kosztuje API w Slotorze?

Nic. Klucze, zapytania i webhooki nie zużywają kredytów i nie mają abonamentu; jedynym ograniczeniem jest sto dwadzieścia zapytań na minutę na klucz.

Gdzie znajdę ustawienia API?

W przeglądarce, w Ustawieniach → API i webhooki. Jeśli tej pozycji nie widzisz, włącz moduł „API i eksport dla księgowej” w ekranie „Funkcje, z których korzystam”.

Czy pracownica może założyć klucz?

Nie. Klucze i webhooki tworzy i zmienia tylko właścicielka albo administratorka salonu, bo klucz otwiera dane wszystkich klientek.

Czy narzędzie może zapisać klientkę poza godzinami pracy?

Nie. Rezerwacja przez API musi trafić w termin, który salon sam oferuje online. Wyjątki od reguł nadal ustawia osoba w recepcji.

Potrzebuję tylko pliku dla księgowej. Czy muszę używać API?

Nie. Klientki, wizyty i usługi pobierzesz jako arkusz CSV, a całość konta jako jeden plik JSON, bez żadnego klucza. API przydaje się dopiero wtedy, gdy dane mają płynąć same.

Co się stanie, gdy unieważnię klucz?

Narzędzie, które go używa, od razu traci dostęp, a pozostałe klucze działają dalej. Dlatego każde narzędzie powinno dostać osobny klucz z własną nazwą.

Podłącz pierwsze narzędzie jeszcze dziś

Załóż konto, utwórz klucz z samym czytaniem wizyt i wyślij test do Zapiera albo Make. Jeśli coś nie zadziała, napisz na hello@slotora.io i opisz, które narzędzie łączysz.