Webhook-lar, serverdən serverə postback-lər və REST API

TapTime-ı başqa sistemlərə qoşmağın üç yolu, hamısı bir bölmədə. Onları yalnız şirkət sahibi idarə edə bilər. Çat bildirişləri və Zapier, Make, n8n və ya Pipedream üçün onların öz bələdçilərinə baxın — onlar eyni hadisələrdən istifadə edir.

Panel İnteqrasiyalar Webhook və API

Nə	Nə vaxt
Webhook	Öz sisteminiz və ya CRM hər rezervasiya, sifariş və ya loyallıq dəyişikliyindən bütün detalları ilə xəbər tutmalıdır.
Postback	Reklam şəbəkəsi, partnyor və ya treker sizə hər konversiyada çağırılacaq postback URL-i verib.
REST API	Sisteminiz rezervasiyaları istədiyi vaxt götürmək, yaxud onları təsdiqləmək və ləğv etmək istəyir.

Göndərilə bilən hadisələr

Hadisə	Nə vaxt
booking.requested	Qonaq sizin təsdiqinizi gözləyən rezervasiya istədi
booking.confirmed	Rezervasiya təsdiqləndi
booking.cancelled	Qonaq və ya məkan ləğv etdi
booking.no_show	Qonaq gəlmədi
booking.completed	Səfər başa çatdı
order.placed	Qonağın sifarişi sizə çatdı (səhifənizdən və ya masanın QR kodundan)
order.paid	İstənilən sifariş ödənildi, kassada ödənilənlər də daxil olmaqla
loyalty.member_joined	Müştəri proqramda ilk möhürünü aldı
loyalty.stamp_added	Möhür əlavə edildi
loyalty.reward_issued	Kart tamamlandı və mükafatı verildi
loyalty.reward_redeemed	Mükafat təhvil verildi

Webhook-lar

1
Webhook əlavə et
Endpoint-inizin https ünvanını yapışdırın və hadisələri seçin — rezervasiyalar, sifarişlər, loyallıq və ya hamısı.
2
Test göndər
Nümunə hadisə dərhal göndərilir və endpoint-inizin verdiyi cavab göstərilir.
3
İmzanı yoxlayın
Hər sorğuda TapTime-Signature başlığı var: t=<time>,v1=<imza sirrinizlə «t.body» üzrə HMAC-SHA256>. Sorğuya etibar etməzdən əvvəl imzanı tutuşdurun.

Gövdə JSON formatındadır: hadisənin ID-si, növü və vaxtı, həmçinin data.booking, data.order və ya data.loyalty altında bütöv rezervasiya, sifariş və ya loyallıq kartı — qonaq, vaxt, masa, xidmət və ya məhsullar, status və haradan gəldiyi (UTM teqləri və klik ID-ləri) ilə.

İstənilən 2xx statusu ilə cavab verin. Qalan hər şey təxminən bir gün ərzində 8 dəfə təkrarlanır.
Hər hadisənin ID-si var: eyni hadisəni iki dəfə alsanız, ikincisinə məhəl qoymayın.
410 Gone ilə cavab versəniz, TapTime həmin hadisəni təkrarlamağı dayandırır.
Yönləndirmələrə əməl olunmur, özəl şəbəkələrdəki ünvanlar isə rədd edilir.

Serverdən serverə postback-lər

Trekerinizin verdiyi postback URL-ini yapışdırın və rezervasiya məlumatlarını daxil etmək üçün dəyişənlərə klikləyin, məsələn https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Mövcud dəyişənlər arasında {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} və {fbclid} var. Trekerin klik ID-si rezervasiya linkinizdə click_id, clickid və ya subid olduqda rezervasiyaya çatır.

REST API

1
API açarı yarat
Ona ad verin və yalnız oxuma, ya da təsdiqləməyə, ləğv etməyə və «gəlmədi» kimi qeyd etməyə icazə verən oxuma və yazma rejimini seçin.
2
Onu indi köçürün
Açar yalnız bir dəfə göstərilir. Onu serverinizdə saxlayın — heç vaxt veb səhifədə və ya tətbiqdə yox.
3
API-ni çağırın
Açarı Authorization: Bearer <key> kimi https://api.tapti.me/v1/company ünvanına göndərin.

Sorğu	Nə qaytarır
GET /v1/company	Açarın aid olduğu şirkət
GET /v1/company/reservations, /appointments	status, branchId, from, to və ya updatedSince ilə filtrlənmiş rezervasiyalar, səhifədə 100
GET /v1/company/reservations/{id}	Bir rezervasiya
POST /v1/company/reservations/{id}/status	Statusu dəyişir (yazma açarları)
GET /v1/company/orders, /orders/{id}	Məhsulları və cəmləri ilə sifarişlər; status, source, fulfilment, from, to və ya paidSince ilə filtrlənir
GET /v1/company/loyalty/programs, /cards, /rewards	Loyallıq proqramları, üzvlərin kartları və qazandıqları mükafatlar
GET /v1/company/events?after={cursor}	Bütün rezervasiya, sifariş və loyallıq hadisələri ardıcıllıqla — sinxron qalmaq üçün mütəmadi sorğulayın; yalnız bəziləri üçün type=order,loyalty əlavə edin
POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id}	URL-i hadisələrə abunə edin və abunəliyi ləğv edin — Zapier, Make, n8n və Pipedream tətbiqləri bundan istifadə edir

Nəsə alınmayanda

Hər endpoint-in Göndərmə jurnalı onun son 25 göndərməsini status kodu və sisteminizin verdiyi cavabla göstərir. Uğursuz göndərmələr özü təkrarlanır; «Yenidən göndər» birini dərhal təkrarlayır.

Tez-tez verilən suallar

Webhook Zapier və ya Make-ə gedə bilər?

Bəli — İnteqrasiyalar → Avtomatlaşdırma bölməsindən istifadə edin: o, ünvanın platformaya aid olduğunu yoxlayır və platformanın öz addımlarını göstərir. «Catch hook» (Zapier), «Custom webhook» (Make), Webhook node-u (n8n) və ya HTTP tətiyi (Pipedream) yaradın, onun ünvanını yapışdırın və alət sahələri öyrənsin deyə «Test göndər» düyməsini basın.

İmza sirrimi itirmişəm.

Sahib onu endpoint-dən yenidən göstərə və ya yeniləyə bilər. Yeniləmə dərhal yeni sirr yaradır, köhnəsi isə işləməyi dayandırır.

Bu məqalə faydalı oldu?

Bu sualınıza cavab vermədi?

Bizə yazın və hansı səhifədə olduğunuzu qeyd edin. Hər mesajı insan oxuyur və cavab yazdığınız dildə gəlir.

Bizə yazın