Az API kulcsokat az Integrációk oldal API kulcsok szekciójában kezelheted. A jelenlegi dashboard folyamat integrációs típusú kulcsokat hoz létre, ahol kiválaszthatod a kulcs fajtáját, a hozzá tartozó jogosultságokat, megadhatsz opcionális lejáratot, és később vissza is vonhatod a kulcsot, ha már nincs rá szükség.
InformációAz API kulcsok és a Bokko Public API használata Pro csomagban érhető el. Free vagy Starter csomag esetén az API kulcsok funkció nem használható aktív integrációhoz.
Új API kulcs létrehozása
- A dashboardon nyisd meg az Integrációk oldalt.
- Az API kulcsok szekcióban kattints a Létrehozás gombra.
- Adj nevet a kulcsnak.
- Válaszd ki a kulcs fajtáját: Tulajdonos integráció vagy Foglalási partner.
- Válassz ki legalább egy jogosultságot.
- Ha szeretnéd, állíts be lejárati dátumot.
- Erősítsd meg a létrehozást.
FigyelemA Bokko a nyers API kulcsot csak egyszer mutatja meg, közvetlenül a létrehozás után. Mentsd el biztonságosan még a párbeszédablak bezárása előtt, mert később a teljes kulcs már nem jelenik meg újra.
Kulcsfajták
| Fajta | Mire való |
|---|---|
| Tulajdonos integráció | Általános tulajdonosi oldali integrációkhoz. Ennél a fajtánál a párbeszédablak teljes jogosultságkészlete használható. |
| Foglalási partner | Külső foglalási partner integrációkhoz, amelyek a vendég nevében dolgoznak. Ennél a fajtánál csak a vendégoldali foglalási folyamathoz tartozó jogosultságok választhatók. |
Ha Foglalási partner fajtát választasz, a Bokko a választható jogosultságokat a vendégoldali műveletekre szűkíti: services.read, staff.read, availability.read és booking.create.
Elérhető jogosultságok
| Jogosultság | Mit enged |
|---|---|
| availability.read | Elérhetőségi adatok olvasása |
| booking.create | Foglalások létrehozása API-n keresztül |
| booking.read | Foglalási adatok olvasása |
| booking.cancel | Foglalások lemondása API-n keresztül |
| services.read | Szolgáltatások olvasása |
| staff.read | Munkatársadatok olvasása |
| webhook.manage | Webhookkal kapcsolatos kezelés |
| subscription.read | Előfizetési állapot és kvóták olvasása |
InformációA teljes Public API jogosultságlistája a fejlesztői dokumentációban található. A dashboard aktuális létrehozó párbeszédablaka ennél szűkebb jogosultságkészletet is mutathat.
Mit látsz a kulcslistában?
- A kulcs neve
- A kulcs végződése a teljes titok helyett
- Jogosultságjelölők
- Állapot, például aktív, lejárt vagy visszavont
- Utolsó használat dátuma, ha a Bokko rendelkezik használati adattal
Kulcs visszavonása
- Keresd meg a kulcsot az API kulcsok listában.
- Kattints a Visszavonás gombra.
- Erősítsd meg a műveletet.
A visszavonás akkor jó döntés, ha a kulcsra már nincs szükség, kompromittálódott, vagy azonnal le kell állítanod a használatát. A Bokko a kulcsot ilyenkor is a listában tartja visszavont állapottal, de a teljes titkos értéket nem mutatja meg újra.
InformációFejlesztői dokumentáció: Az API kulcsok használatának teljes technikai részletei (Bearer hitelesítés, jogosultsági mátrix, kérési limitek, kódpéldák) a Bokko Public API – Hitelesítés oldalon.