API és webhookok a szalonodhoz: a foglalásaid a saját eszközeidben
A könyvelőd a hónap foglalásait táblázatban kéri, a hírlevél-programodnak kellenek az új vendégek, az unokaöcséd pedig a weboldaladra tenné ki a szabad időpontokat. Ehhez nem kell exportálgatnod. A Beállításokban kulcsot készítesz, megadod, mit láthat, és a Zapier vagy a Make programozó nélkül elviszi az adatot oda, ahová kell.
0 Ft/hó · 0% jutalék · regisztrációhoz nem kell bankkártya · korlátlan foglalás és vendég · az SMS és amit az AI készít, feltölthető kreditből megy
Szalonfiók nyitásaMire kötik be a szalonok
A könyvelő táblázata
Minden új foglalás és fizetés egy sor a Google Táblázatban. A kulcs csak a foglalásokat olvassa, a vendégek elérhetőségét nem kell látnia.
Hírlevél-program
Az új vendég bekerül a listádra. Minden vendégnél ott a jelzés, ha leiratkozott, így a hírlevél-eszköz kihagyhatja.
A saját weboldalad
A szabad időpontok az API-ból jönnek, és a foglalás ugyanúgy jön létre, mint amikor te veszed fel a pultnál.
Saját értesítés
Egy lemondásról azonnal üzenet a csapat csatornájába, vagy egy új vendégről e-mail neked, ahogy a Zapier vagy a Make engedi.
Mit tehet egy kulcs
Minden eszköz kapjon saját kulcsot, és csak azt, amire szüksége van. Ha egyet kikapcsolsz, a többi tovább működik.
| Jogosultság | Mit enged |
|---|---|
| Foglalások olvasása | Időpontok a vendég nevével, a szolgáltatással, a kollégával, az árral és a fizetéssel; a szabad időpontok |
| Vendégek olvasása | Név, telefonszám, e-mail, nyelv és marketinghozzájárulás; megjegyzés soha |
| Szolgáltatások és csapat olvasása | A szolgáltatáslistád árral és időtartammal, a kollégák és a helyszínek |
| Foglalás létrehozása | Szabad időpontra foglal, úgy, mint a pult; alapból ki van kapcsolva |
Kulcsot a tulajdonos vagy egy admin készíthet. Egyszer jelenik meg, utána a Slotora sem tudja visszaolvasni, és megszűnik, ha a készítője már nem kezeli a szalont.
A végpontok, annak, aki megépíti
Minden JSON, HTTPS-en, a https://slotora.io/api/v1 címen. A kulcs az Authorization fejlécben megy Bearer előtaggal, vagy X-Api-Key fejlécben. Az időpontok a szalon időzónájában jönnek, eltolással.
| Kérés | Mit ad vissza |
|---|---|
| GET /api/v1/me | A szalonod és a kulcs jogosultságai, a kapcsolat kipróbálásához |
| GET /api/v1/bookings | Foglalások: alapból mától 31 napra, vagy két dátum között, legfeljebb egy évre |
| GET /api/v1/availability | Szabad időpontok egy szolgáltatásra egy adott napon |
| POST /api/v1/bookings | Új foglalás meglévő vagy új vendégnek |
| GET /api/v1/clients | A vendéglista, a létrehozás vagy a módosítás dátuma szerint szűrve |
| GET /api/v1/services, /staff, /premises | Szolgáltatások, kollégák, helyszínek |
A listák lapozva jönnek, egyszerre legfeljebb száz sor. Kulcsonként percenként 120 kérés mehet, efölött a válasz 429-es. A gép által olvasható leírás az /api/v1/openapi.json címen van.
Zapierrel, lépésről lépésre
A Make ugyanígy megy: ott a Webhooks modul Custom webhook lépésével kezdesz.
01
A Zapierben elkapod a horgot
Új Zap, a kiváltó esemény Webhooks by Zapier, azon belül Catch Hook. A Zapier ad egy címet, ezt kimásolod.
02
A Slotorában hozzáadod
Beállítások, API és webhookok, Webhookok: beilleszted a címet, kipipálod, mit küldjünk, például új foglalás és fizetés, és hozzáadod.
03
Küldesz egy próbát
A Próba küldése gombbal minta foglalás megy ki, valódi vendég adatai nélkül. A Zapier ebből tanulja meg a mezőket.
04
Megmondod, hová menjen
Hozzáadod a lépést, például egy új sort a Google Táblázatba, és párosítod a mezőket. Ettől kezdve minden új foglalás magától bekerül.
Webhookok: mikor érkeznek, és mi van, ha nem
Öt eseményt küldhetünk: új foglalás, módosult foglalás, lemondott foglalás, új vendég és rögzített fizetés. A Slotora negyedóránként nézi meg, mi változott, ezért egy esemény nagyjából tizenöt percen belül érkezik meg, nem azonnal.
Ha az eszközöd tíz másodpercen belül nem válaszol sikerrel, újrapróbáljuk egy, öt és harminc perc, majd két, hat, tizenkét és huszonnégy óra múlva. Tizenöt egymást követő hiba vagy három nap sikertelenség után a címet kikapcsoljuk, és értesítést küldünk a tulajdonosnak. Ha rendbe tetted, ugyanott visszakapcsolod.
Minden üzenetünket aláírjuk. A fejlécben a Slotora-Signature mezőben időbélyeg és HMAC-SHA256 aláírás áll, amit a webhook titkos kulcsával ellenőrizhetsz. A titkos kulcs csak a létrehozáskor látszik egyszer. A Zapiernek és a Make-nek erre nincs szüksége, egy saját szervernek igen.
Amit az API nem tud
- Nincs Slotora alkalmazás a Zapier és a Make katalógusában
- A Webhooks és a HTTP modulokkal kötöd be, ahogy fent. Ezekhez nem kell katalógusbeli alkalmazás.
- A webhook nem azonnali
- Negyedórás késéssel számolj. Ha valaminek percre pontosan kell érkeznie, az API-t kérdezd le gyakrabban.
- Kulcsot csak böngészőben készíthetsz
- A telefonos appban látod a kulcsokat, a webhookokat és a kérésnaplót, de létrehozni és módosítani a gépen tudod.
- A mezőnevek angolul vannak
- A végpontok, a mezők és a gépi leírás angol nevűek, ahogy a legtöbb API-ban. Ez az oldal az egyetlen magyar útmutató hozzájuk.
- Számlát és nyugtát nem az API ad
- Ha automatikus számlát szeretnél, azt a Számlázz.hu vagy a Billingo bekötése adja, nem ez.
Kérdések az API-ról
Kerül valamibe az API?
Nem. A kulcsok, a kérések és a webhookok díj nélkül járnak, a korlát kulcsonként percenként 120 kérés.
Foglalhat egy eszköz a nyitvatartásomon kívülre?
Nem. Az API-n keresztül csak olyan időpontra lehet foglalni, amit a szalon kínál, és a szobákat, gépeket is ugyanúgy figyeli. A vendég a szokásos visszaigazolást kapja.
Mi történik, ha egy foglalási kérés kétszer megy el?
Ha a kérés Idempotency-Key fejlécet visz, öt percen belül az ismételt kérés az elsőként létrejött foglalást adja vissza, nem csinál másodikat.
Kiadja a vendégek telefonszámát?
Csak ha a csapatod is láthatja. Ha a Beállításokban elrejtetted a vendégek elérhetőségét, az API és a webhook is üresen adja vissza. A vendégről írt megjegyzés soha nem megy ki.
Hol találom a kulcsokat a Slotorában?
A böngészőben a Beállítások között, az API és webhookok soron. Ott vannak a kulcsok, a webhookok és a kérésnapló is, egy oldalon.
Visszakereshető, mit kérdezett le egy kulcs?
Igen, a kérésnaplóban az elmúlt 30 nap minden kérése ott van, a legújabbal kezdve.
Kösd össze a szalont azzal, amit már használsz
Nyiss szalonfiókot, készíts kulcsot a Beállításokban, és küldj egy próbát a Zapierbe vagy a Make-be még ma este.