Уебхукове, постбекове между сървъри и REST API

Три начина да свържете TapTime с други системи, събрани на едно място. Само собственикът на фирмата може да ги управлява. За известията в чата и за Zapier, Make, n8n или Pipedream вижте отделните им ръководства — те използват същите събития.

Панел Интеграции Уебхукове и API

Използвайте	Кога
Уебхук	Вашата система или CRM трябва да научава за всяка промяна в резервация, поръчка или карта за лоялност с всички подробности.
Постбек	Рекламна мрежа, афилиейт или тракер ви е дал постбек адрес, който да се извиква при всяка конверсия.
REST API	Системата ви иска да изтегля резервации, когато ѝ е удобно, или да ги потвърждава и отказва.

Събития, които можете да изпращате

Събитие	Кога
booking.requested	Гост е заявил резервация, която чака вашето потвърждение
booking.confirmed	Резервацията е потвърдена
booking.cancelled	Гостът или обектът е отменил
booking.no_show	Гостът не е дошъл
booking.completed	Посещението е приключило
order.placed	Поръчка на гост е стигнала до вас (от страницата ви или от QR кода на маса)
order.paid	Платена е поръчка, включително на касата
loyalty.member_joined	Клиент е получил първия си печат в програма
loyalty.stamp_added	Добавен е печат
loyalty.reward_issued	Карта е запълнена и наградата ѝ е издадена
loyalty.reward_redeemed	Награда е предадена на госта

Уебхукове

1
Добави уебхук
Поставете https адреса на крайната си точка и изберете събитията — резервации, поръчки, лоялност или всички.
2
Изпрати тест
Примерно събитие се изпраща веднага и се показва отговорът на крайната ви точка.
3
Проверете подписа
Всяка заявка има заглавка TapTime-Signature: t=<time>,v1=<HMAC-SHA256 на „t.body“ с вашия таен ключ за подпис>. Сравнете я, преди да се доверите на заявката.

Тялото е JSON: ID, тип и час на събитието и цялата резервация, поръчка или карта за лоялност в data.booking, data.order или data.loyalty — с госта, часа, масата, услугата или артикулите, статуса и откъде е дошла (UTM параметри и ID на кликове).

Отговорете с какъвто и да е 2xx статус. Всичко друго се повтаря 8 пъти в рамките на около денонощие.
Всяко събитие има ID: ако го получите два пъти, пренебрегнете второто.
Отговорете с 410 Gone и TapTime спира да повтаря това събитие.
Пренасочванията не се следват, а адресите в частни мрежи се отказват.

Постбекове между сървъри

Поставете постбек адреса, който ви е дал тракерът, и кликнете върху променливите, за да вмъкнете данни от резервацията, например https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Наличните променливи включват {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} и {fbclid}. ID на клика от тракера стига до резервацията, когато връзката ви за резервации носи click_id, clickid или subid.

REST API

1
Създай API ключ
Дайте му име и изберете „Само четене“ или „Четене и запис“, за да позволите потвърждаване, отказване и отбелязване на неявявания.
2
Копирайте го веднага
Ключът се показва само веднъж. Пазете го на сървъра си — никога в уеб страница или приложение.
3
Извикайте API
Изпращайте го като Authorization: Bearer <key> към https://api.tapti.me/v1/company.

Заявка	Връща
GET /v1/company	Фирмата, към която принадлежи ключът
GET /v1/company/reservations, /appointments	Резервации, филтрирани по status, branchId, from, to или updatedSince, по 100 на страница
GET /v1/company/reservations/{id}	Една резервация
POST /v1/company/reservations/{id}/status	Промяна на статуса (ключове за запис)
GET /v1/company/orders, /orders/{id}	Поръчки с артикулите и сумите им, филтрирани по status, source, fulfilment, from, to или paidSince
GET /v1/company/loyalty/programs, /cards, /rewards	Програмите за лоялност, картите на членовете и спечелените от тях награди
GET /v1/company/events?after={cursor}	Всяко събитие за резервация, поръчка и лоялност поред — проверявайте го редовно, за да сте синхронизирани; добавете type=order,loyalty само за някои
POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id}	Абонира URL адрес за събития и го отписва — това използват приложенията за Zapier, Make, n8n и Pipedream

Когато нещо се провали

„Дневник на изпращанията“ на всяка крайна точка изброява последните ѝ 25 изпращания с кода на статуса и отговора на вашата система. Неуспешните изпращания се повтарят сами; „Изпрати отново“ повтаря едно от тях веднага.

Често задавани въпроси

Може ли уебхук да отиде към Zapier или Make?

Да — използвайте Интеграции → Автоматизация, където се проверява, че адресът принадлежи на платформата, и се показват нейните стъпки. Създайте „Catch hook“ (Zapier), „Custom webhook“ (Make), възел Webhook (n8n) или HTTP тригер (Pipedream), поставете адреса му и натиснете „Изпрати тест“, за да научи инструментът полетата.

Загубих тайния ключ за подпис.

Собственикът може да го покаже отново от крайната точка или да го смени. Смяната издава нов ключ веднага, а старият спира да работи.

Беше ли полезна тази статия?

Това не отговори ли на въпроса ви?

Пишете ни и посочете страницата, на която сте били. Всяко съобщение се чете от човек и отговорът идва на езика, на който сте писали.

Пишете ни