Kako doći do svog Phobs API ključa

Svaki PhobsPMS modul povezuje se s vašim Phobs klijentskim područjem preko API ključa koji vi generirate unutar Phobs sučelja. Ključ je specifičan za vaš objekt i može se opozvati kad god poželite. Ovaj vodič opisuje postupak.

1. Prijava u Phobs klijentsko područje

Otvorite web adresu koju vam je Phobs d.o.o. dostavio prilikom sklapanja pretplate (obično je oblika https://client.phobs.hr ili slično). Prijavite se svojim korisničkim imenom i lozinkom. Ako niste sigurni koje su vaše kredencijale za Phobs klijentsko područje, obratite se izravno Phobs podršci — PhobsPMS ne može ih doći umjesto vas.

2. Otvaranje sekcije API pristupa

U izborniku slijeva pronađite Postavke → Integracije → API pristup. Točan naziv i mjesto mogu se razlikovati ovisno o verziji Phobs-a koju koristite. Ako opciju API pristupa ne vidite, moguće da vaša Phobs pretplata ne uključuje API. U tom slučaju obratite se Phobs prodaji za nadogradnju pretplate.

3. Generiranje novog API ključa

Kliknite gumb „Generiraj novi API ključ". Otvorit će se dijalog s poljem za naziv ključa — unesite npr. „PhobsPMS integracija" da lako prepoznate koji ključ pripada kojoj integraciji. Odaberite opseg ovlasti: minimalne ovlasti nužne za rad naših modula su „read:reservations", „read:rates", „read:availability", „write:availability" (za konektor OTA), „write:invoices" (za fiskalizaciju).

Odmah kopirajte prikazani ključ — Phobs u pravilu prikaže cijeli ključ samo jednom, radi sigurnosti. Ako ga izgubite, morat ćete generirati novi.

4. Unos ključa u PhobsPMS

U svom PhobsPMS klijentskom području otvorite Postavke → Phobs povezanost → API ključ. Zalijepite ključ u polje i kliknite „Spremi i testiraj". Sustav automatski testira ključ pozivom na /health endpoint Phobs API-ja i vraća potvrdu ili razlog eventualnog neuspjeha (najčešće: pogrešan ključ, neaktivan opseg, IP restrikcija).

5. Prva sinkronizacija

Nakon uspješnog testa, aktivirani moduli počinju čitati podatke iz Phobs-a u sljedećih 15 minuta. Prvi puni pregled rezervacija (za posljednjih 90 dana + budućih 365 dana) izvršava se odmah, a inkrementalne sinkronizacije nastavljaju se u konfiguriranom intervalu (obično svakih 5-15 minuta ovisno o modulu).

Sigurnosne preporuke

• Ključ nikada ne dijelite izvan svoje tvrtke. PhobsPMS podrška nikada neće tražiti ključ od vas.
• Ako sumnjate na kompromitaciju, opozovite ključ u Phobs klijentskom području i generirajte novi.
• Ograničite IP raspon iz kojeg ključ smije biti korišten na server IP-eve PhobsPMS-a: 78.46.11.0/24 (dostupno u dokumentaciji).