Preskoči na sadržaj
Clava Pomoć
Članci u ovoj temi

Povežite vlastitu web-stranicu (API)

Dajte svom web-programeru podatke koji su mu potrebni da obrazac za rezervaciju Clave prikaže na vašoj WordPress web-stranici i saznajte što se događa kad izradite novi tajni ključ.

7 min čitanja

Kartica API integracija namijenjena je restoranima koji već imaju vlastitu WordPress web-stranicu i žele da se na njoj pojavi obrazac za rezervaciju Clave. „API“ je jednostavno način na koji dva programa razgovaraju — ovdje vaša web-stranica i Clava. Vaš web-programer to postavlja pomoću dva podatka s ove kartice: oznake vaše lokacije i tajnog ključa, koji između vaše web-stranice i Clave služi kao lozinka.

Većini vlasnika ova kartica uopće nije potrebna.

Treba li vam ovo?

Što koristite Treba li vam ova kartica?
Web-stranicu koju ste izradili u uređivaču web-stranice Clave Ne. Njezina je stranica za rezervacije već povezana.
Stranicu za rezervacije Clave — poveznicu, gumb ili QR kod Ne. Pogledajte Podijelite adresu web-stranice i stranice za rezervacije.
Vlastitu WordPress web-stranicu na kojoj se treba pojaviti obrazac za rezervaciju Clave Da.

WordPress dodatak dostupan je u paketima Pro i Ultimate — više o tome niže.

Što vidite na kartici

U izborniku Lokacije kliknite Konfiguriraj kod svoje lokacije, a zatim karticu API integracija. Postavke lokacije mogu otvoriti samo administratori — pogledajte Uloge u timu.

Kartica API integracija: GUID lokacije (1) s gumbom Kopiraj (2), API tajni ključ (3) s gumbom oka (4), Ponovno generiraj ključ (5) i okvir Postavljanje WordPress dodatka (6)
Kartica API integracija: GUID lokacije (1) s gumbom Kopiraj (2), API tajni ključ (3) s gumbom oka (4), Ponovno generiraj ključ (5) i okvir Postavljanje WordPress dodatka (6)
  • (1) GUID lokacije je oznaka (ID) ove lokacije. Nije tajna: dio je i adrese vaše stranice za rezervacije.
  • (2) Kopiraj kopira oznaku, da je možete zalijepiti u e-poruku.
  • (3) API tajni ključ je tajni ključ. Čuvajte ga kao PIN bankovne kartice. Polje prikazuje samo zadnjih 8 znakova.
  • (4) Gumb s okom prikazuje ili skriva cijeli ključ.
  • (5) Ponovno generiraj ključ izrađuje novi ključ i čini stari beskorisnim — pogledajte niže.
  • (6) Postavljanje WordPress dodatka kratak je popis onoga što radi programer.

Sve na ovoj kartici djeluje odmah. Ništa se ne sprema.

Dobro je znati

Svaka lokacija ima vlastitu oznaku i vlastiti ključ. Imate li više lokacija, provjerite naziv gore lijevo, iznad popisa kartica, prije nego što bilo što kopirate.

Izradite tajni ključ

Nova lokacija još nema ključ. Kartica tada kaže API tajni ključ još nije generiran. Generirajte ga kako biste omogućili integraciju s WordPress dodatkom.

  1. Kliknite Generiraj API tajni ključ (3).

    Lokacija bez ključa: GUID lokacije (1), napomena da ključ još ne postoji (2) i Generiraj API tajni ključ (3)
    Lokacija bez ključa: GUID lokacije (1), napomena da ključ još ne postoji (2) i Generiraj API tajni ključ (3)

  2. Ključ se odmah izrađuje i pojavljuje se zelena poruka: API tajni ključ uspješno generiran. Novi ključ prikazan je u cijelosti.

Pokraj ključa sada vidite gumb s okom i Ponovno generiraj ključ.

Prikažite i kopirajte ključ

  1. Kliknite gumb s okom (2). Pojavljuje se cijeli ključ.
  2. Kliknite Kopiraj (3) pokraj njega. Gumb Kopiraj za ključ pojavljuje se samo dok je ključ prikazan.
  3. Ponovno kliknite gumb s okom da ključ sakrijete.
Ključ prikazan u cijelosti (1), gumb s okom (2) i Kopiraj (3)
Ključ prikazan u cijelosti (1), gumb s okom (2) i Kopiraj (3)

Ključ se ne prikazuje samo jednom. Svaki administrator vašeg poslovanja može ga ponovno prikazati u bilo kojem trenutku.

Savjet

Sakrijte ključ prije nego što podijelite zaslon ili prijeđete na drugu lokaciju. Kartica pamti da je ključ prikazan pa i ključ sljedeće lokacije prikazuje u cijelosti.

Što poslati web-programeru

Pošaljite ove tri stvari i zamolite programera da koristi WordPress dodatak Clava Booking:

Što Gdje to nalazite
Web-adresa Clave Adresa na kojoj se prijavljujete u Clavu, ali samo prvi dio: od https:// do kraja naziva domene — bez ičega poput /settings/... iza nje. Dodatak to polje zove API URL.
Oznaka vaše lokacije Polje GUID lokacije. Kliknite Kopiraj.
Tajni ključ Polje API tajni ključ. Kliknite gumb s okom, pa Kopiraj.

Vaš programer zatim u WordPressu radi sljedeće. Slijedi plavi okvir na kartici, uz dodani test:

  1. Instalirajte dodatak Clava Booking na svoju WordPress web-stranicu.
  2. U WordPressu otvorite Postavke, zatim Clava Booking, i unesite API URL, Venue GUID i API Secret. Sam je dodatak na engleskom, pa se polja tako zovu. To su isti podaci kao GUID lokacije i API tajni ključ u Clavi. Zatim kliknite WordPressov vlastiti gumb za spremanje promjena na dnu stranice (u engleskom WordPressu piše Save Changes).
  3. Kliknite Test Connection. Test koristi spremljene podatke, pa najprije spremite. Ako je sve ispravno, prikazuje Connection successful! Venue: i naziv vaše lokacije. Ako nije, prikazuje Connection failed: i razlog.
  4. Dodajte kratki kod [loyal_booking] na bilo koju stranicu. Na njoj se pojavljuje obrazac za rezervaciju.

Rezervacije koje gosti naprave preko vaše web-stranice obične su rezervacije. Vrijede ista pravila i isti slobodni termini kao za ostale rezervacije, pojavljuju se na ploči za rezervacije vašeg tima i za njih se šalje uobičajena e-poruka s potvrdom.

Oprez

Tajni ključ pošaljite privatnom porukom ili preko upravitelja lozinki — nikad u javnom chatu ni u grupi. Tko ima oznaku i ključ, može raditi rezervacije u vaše ime. Ako možete, ključ pošaljite odvojeno od oznake.

Nemate datoteku dodatka ili vaš programer želi povezati nešto drugo osim WordPressa? Obratite se timu Clave putem stavke Podrška u izborniku lijevo.

Vaš paket

Sama kartica otvorena je na svakom paketu i ključ možete izraditi na bilo kojem paketu. Ali veza radi samo na paketima koji uključuju WordPress dodatak: Pro i Ultimate. Radi i tijekom besplatnog probnog razdoblja.

Na paketu bez njega obrazac za rezervaciju na vašoj web-stranici ne može rezervirati. Kartica vas na to ne upozorava, pa prije korištenja provjerite svoj paket. Želite li promijeniti paket, obratite se timu Clave putem stavke Podrška.

Izradite novi ključ

Novi ključ izradite samo ako morate — na primjer, ako je stari dospio u krive ruke ili je otišao programer koji ga je znao.

  1. Kliknite Ponovno generiraj ključ (5 na slici kartice). Još se ništa ne mijenja. Otvara se okvir koji pita: Ponovno generiranje API tajnog ključa poništit će sve postojeće integracije s WordPress dodatkom. Jeste li sigurni?

    Pitanje prije izrade novog ključa: upozorenje (1), Da, ponovno generiraj (2) i Odustani (3)
    Pitanje prije izrade novog ključa: upozorenje (1), Da, ponovno generiraj (2) i Odustani (3)

  2. Kliknite Da, ponovno generiraj (2) za nastavak ili Odustani (3) da zadržite svoj ključ.

Kliknete li Da, ponovno generiraj, novi se ključ odmah izrađuje i prikazuje, a pojavljuje se zelena poruka. Stari ključ prestaje raditi odmah. Svaka web-stranica koja ga koristi — a s njom i vaš obrazac za rezervaciju — prestaje primati rezervacije dok netko u WordPressu, pod Postavke, Clava Booking, ne unese novi ključ. Rezervacije koje su gosti već napravili to ne dotiče.

Oprez

Ne izrađujte novi ključ samo da isprobate gumb i nemojte to činiti u prometnoj večeri. Planirajte to i neka vam programer bude spreman s novim ključem.

Nema gumba za isključivanje veze. Želite li neku web-stranicu odsjeći, izradite novi ključ i nikome ga ne dajte.

Kad veza ne radi

Koristite Test Connection u WordPressu. Prikazuje Connection failed:, a iza toga jednu od ovih poruka. Uvijek su na engleskom.

Poruka Što znači Što učiniti
Invalid signature. Ključ ne odgovara: kopiran je s viškom razmaka, riječ je o starom ključu iz vremena prije nego što ste izradili novi ili oznaka pripada drugoj lokaciji. Ponovno kopirajte oznaku i ključ s ove kartice i zalijepite ih u WordPress.
Venue not found. Oznaka je pogrešna. Ponovno kopirajte GUID lokacije.
API integration not configured for this venue. Ova lokacija još nema ključ. Kliknite Generiraj API tajni ključ na kartici.
WordPress plugin feature is not enabled for this venue. Vaš paket ne uključuje WordPress dodatak. Pogledajte Vaš paket.
Request timestamp expired. Sat računala na kojem radi vaša web-stranica odstupa za više od nekoliko minuta. Zamolite pružatelja hostinga ili programera da ispravi vrijeme.
Clava Booking is not configured. Please fill in all required fields. Jedno od triju polja je prazno ili su podaci upisani, ali još nisu spremljeni. Ispunite API URL, Venue GUID i API Secret, spremite promjene i ponovno testirajte.

Ako je poruka API request failed. ili govori o pogrešci veze, vjerojatno je pogrešan API URL. Provjerite je li to samo web-adresa Clave, bez naziva stranice iza nje.