Webhook-ovi, server-to-server postback-ovi i REST API

Tri načina da povežete TapTime sa drugim sistemima, sva na jednom mestu. Samo vlasnik firme može da upravlja njima. Za obaveštenja u četu i za Zapier, Make, n8n ili Pipedream pogledajte njihove posebne vodiče — koriste iste događaje.

Panel Integracije Webhook-ovi i API

Koristite	Kada
Webhook	Vaš sistem ili CRM treba da sazna za svaku promenu rezervacije, porudžbine ili lojalnosti, sa svim detaljima.
Postback	Oglasna mreža, afilijejt ili treker dali su vam postback URL koji treba pozvati pri svakoj konverziji.
REST API	Vaš sistem želi da preuzima rezervacije kad mu odgovara, ili da ih potvrđuje i otkazuje.

Događaji koje možete slati

Događaj	Kada
booking.requested	Gost je zatražio rezervaciju koja čeka vašu potvrdu
booking.confirmed	Rezervacija je potvrđena
booking.cancelled	Otkazao je gost ili lokal
booking.no_show	Gost nije došao
booking.completed	Poseta je završena
order.placed	Porudžbina gosta je stigla do vas (sa vaše stranice ili preko QR koda na stolu)
order.paid	Bilo koja porudžbina je plaćena, uključujući i na kasi
loyalty.member_joined	Kupac je dobio prvi pečat u programu
loyalty.stamp_added	Dodat je pečat
loyalty.reward_issued	Kartica je popunjena i nagrada je izdata
loyalty.reward_redeemed	Nagrada je uručena

Webhook-ovi

1
Dodaj webhook
Nalepite https adresu svog endpointa i izaberite događaje — rezervacije, porudžbine, lojalnost ili sve.
2
Pošalji test
Primer događaja odlazi odmah, a prikazuje se odgovor vašeg endpointa.
3
Proverite potpis
Svaki zahtev ima zaglavlje TapTime-Signature: t=<time>,v1=<HMAC-SHA256 od „t.body“ sa vašim tajnim ključem za potpis>. Uporedite ga pre nego što poverujete zahtevu.

Telo je JSON: ID, vrsta i vreme događaja i cela rezervacija, porudžbina ili kartica lojalnosti pod data.booking, data.order ili data.loyalty — sa gostom, vremenom, stolom, uslugom ili stavkama, statusom i podatkom odakle je stigla (UTM parametri i ID-jevi klikova).

Odgovorite bilo kojim 2xx statusom. Sve ostalo se ponavlja 8 puta tokom otprilike jednog dana.
Svaki događaj ima ID: ako ga primite dvaput, zanemarite drugi.
Odgovorite sa 410 Gone i TapTime prestaje da ponavlja taj događaj.
Preusmerenja se ne prate, a adrese u privatnim mrežama se odbijaju.

Server-to-server postback-ovi

Nalepite postback URL koji vam je dao treker i kliknite na promenljive da biste umetnuli podatke o rezervaciji, na primer https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Dostupne promenljive uključuju {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} i {fbclid}. ID klika iz trekera stiže do rezervacije kada vaš link za rezervaciju nosi click_id, clickid ili subid.

REST API

1
Napravi API ključ
Dajte mu naziv i izaberite „Samo čitanje“ ili „Čitanje i pisanje“ da biste dozvolili potvrđivanje, otkazivanje i označavanje nedolazaka.
2
Odmah ga kopirajte
Ključ se prikazuje samo jednom. Čuvajte ga na svom serveru — nikada na veb-stranici ili u aplikaciji.
3
Pozovite API
Šaljite ga kao Authorization: Bearer <key> na https://api.tapti.me/v1/company.

Zahtev	Vraća
GET /v1/company	Firmu kojoj ključ pripada
GET /v1/company/reservations, /appointments	Rezervacije, filtrirane po status, branchId, from, to ili updatedSince, 100 po stranici
GET /v1/company/reservations/{id}	Jednu rezervaciju
POST /v1/company/reservations/{id}/status	Menja status (ključevi za pisanje)
GET /v1/company/orders, /orders/{id}	Porudžbine sa stavkama i iznosima, filtrirane po status, source, fulfilment, from, to ili paidSince
GET /v1/company/loyalty/programs, /cards, /rewards	Programe lojalnosti, kartice članova i nagrade koje su osvojili
GET /v1/company/events?after={cursor}	Svaki događaj rezervacije, porudžbine i lojalnosti redom — proveravajte ga redovno da biste ostali usklađeni; dodajte type=order,loyalty za samo neke
POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id}	Pretplaćuje URL na događaje i otkazuje pretplatu — to koriste aplikacije za Zapier, Make, n8n i Pipedream

Kada nešto ne uspe

„Dnevnik isporuka“ svakog endpointa prikazuje njegovih poslednjih 25 isporuka sa statusnim kodom i odgovorom vašeg sistema. Neuspele isporuke se same ponavljaju; „Pošalji ponovo“ ponavlja jednu odmah.

Česta pitanja

Može li webhook da ide u Zapier ili Make?

Da — koristite Integracije → Automatizacija, koja proverava da li adresa pripada platformi i prikazuje njene korake. Napravite „Catch hook“ (Zapier), „Custom webhook“ (Make), Webhook čvor (n8n) ili HTTP okidač (Pipedream), nalepite njegovu adresu i pritisnite „Pošalji test“ da bi alat naučio polja.

Izgubio sam tajni ključ za potpis.

Vlasnik može ponovo da ga prikaže na endpointu ili da ga zameni. Zamena odmah izdaje novi ključ, a stari prestaje da radi.

Da li je ovaj članak bio koristan?

Ovo nije odgovorilo na vaše pitanje?

Pišite nam i navedite stranicu na kojoj ste bili. Svaku poruku čita čovek, a odgovor stiže na jeziku na kom ste pisali.

Pišite nam