Webhook'lar, sunucudan sunucuya postback'ler ve REST API

TapTime'ı başka sistemlere bağlamanın üç yolu, hepsi tek bir başlık altında. Bunları yalnızca işletme sahibi yönetebilir. Sohbet bildirimleri ve Zapier, Make, n8n veya Pipedream için kendi kılavuzlarına bakın — aynı etkinlikleri kullanırlar.

Panel Entegrasyonlar Webhook’lar ve API

Yöntem	Ne zaman
Webhook	Kendi sisteminiz veya bir CRM her rezervasyon, sipariş veya sadakat değişikliğinden tüm ayrıntılarıyla haberdar olmalı.
Postback	Bir reklam ağı, satış ortağı veya takip aracı size her dönüşümde çağrılacak bir postback URL'si verdi.
REST API	Sisteminiz rezervasyonları istediği zaman çekmek ya da onaylayıp iptal etmek istiyor.

Gönderebileceğiniz etkinlikler

Etkinlik	Ne zaman
booking.requested	Bir misafir, onayınızı bekleyen bir rezervasyon talep etti
booking.confirmed	Bir rezervasyon onaylandı
booking.cancelled	Misafir veya işletme iptal etti
booking.no_show	Misafir gelmedi
booking.completed	Ziyaret sona erdi
order.placed	Bir misafirin siparişi size ulaştı (sayfanızdan veya bir masanın QR kodundan)
order.paid	Kasada ödenenler dahil, herhangi bir sipariş ödendi
loyalty.member_joined	Bir müşteri bir programdaki ilk damgasını aldı
loyalty.stamp_added	Bir damga eklendi
loyalty.reward_issued	Bir kart tamamlandı ve ödülü verildi
loyalty.reward_redeemed	Bir ödül teslim edildi

Webhook'lar

1
Webhook ekle
Uç noktanızın https adresini yapıştırın ve etkinlikleri seçin — rezervasyonlar, siparişler, sadakat ya da hepsi.
2
Test gönder
Hemen örnek bir etkinlik gönderilir ve uç noktanızın verdiği yanıt gösterilir.
3
İmzayı doğrulayın
Her istekte bir TapTime-Signature başlığı bulunur: t=<time>,v1=<imzalama anahtarınızla “t.body” için HMAC-SHA256>. İsteğe güvenmeden önce imzayı karşılaştırın.

Gövde JSON'dur: etkinlik kimliği, türü ve zamanı ile data.booking, data.order veya data.loyalty altında rezervasyonun, siparişin veya sadakat kartının tamamı — misafir, saat, masa, hizmet veya ürünler, durum ve nereden geldiği (UTM etiketleri ve tıklama kimlikleri) ile.

Herhangi bir 2xx durum koduyla yanıt verin. Diğer her yanıt yaklaşık bir gün içinde 8 kez yeniden denenir.
Her etkinliğin bir kimliği vardır: aynı etkinliği iki kez alırsanız ikincisini yok sayın.
410 Gone ile yanıt verirseniz TapTime o etkinliği yeniden denemeyi bırakır.
Yönlendirmeler izlenmez ve özel ağlardaki adresler reddedilir.

Sunucudan sunucuya postback'ler

Takip aracınızın verdiği postback URL'sini yapıştırın ve rezervasyon bilgilerini eklemek için yer tutuculara tıklayın, örneğin https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Kullanılabilen yer tutucular arasında {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} ve {fbclid} bulunur. Takip aracının tıklama kimliği, rezervasyon bağlantınız click_id, clickid veya subid taşıdığında rezervasyona ulaşır.

REST API

1
API anahtarı oluştur
Bir ad verin ve salt okunur ya da onaylamaya, iptal etmeye ve gelmedi olarak işaretlemeye izin veren okuma ve yazma seçeneğini seçin.
2
Hemen kopyalayın
Anahtar yalnızca bir kez gösterilir. Sunucunuzda saklayın — asla bir web sayfasında ya da uygulamada değil.
3
API'yi çağırın
Anahtarı Authorization: Bearer <key> olarak https://api.tapti.me/v1/company adresine gönderin.

İstek	Döndürdüğü
GET /v1/company	Anahtarın ait olduğu şirket
GET /v1/company/reservations, /appointments	status, branchId, from, to veya updatedSince ile filtrelenmiş rezervasyonlar, sayfa başına 100
GET /v1/company/reservations/{id}	Tek bir rezervasyon
POST /v1/company/reservations/{id}/status	Durumu değiştirir (yazma anahtarları)
GET /v1/company/orders, /orders/{id}	Ürünleri ve toplamlarıyla siparişler; status, source, fulfilment, from, to veya paidSince ile filtrelenir
GET /v1/company/loyalty/programs, /cards, /rewards	Sadakat programları, üyelerin kartları ve kazandıkları ödüller
GET /v1/company/events?after={cursor}	Tüm rezervasyon, sipariş ve sadakat etkinlikleri sırasıyla — senkron kalmak için düzenli olarak sorgulayın; yalnızca bazıları için type=order,loyalty ekleyin
POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id}	Bir URL'yi etkinliklere abone edin ve aboneliği kaldırın — Zapier, Make, n8n ve Pipedream uygulamalarının kullandığı yöntem

Bir şey başarısız olduğunda

Her uç noktanın Gönderim günlüğü son 25 gönderimini durum koduyla ve sisteminizin verdiği yanıtla listeler. Başarısız gönderimler kendiliğinden yeniden denenir; “Yeniden gönder” birini hemen yeniden dener.

Sık sorulanlar

Bir webhook Zapier'e veya Make'e gidebilir mi?

Evet — Entegrasyonlar → Otomasyon bölümünü kullanın; adresin platforma ait olduğunu kontrol eder ve platformun kendi adımlarını gösterir. Bir “Catch hook” (Zapier), bir “Custom webhook” (Make), bir Webhook düğümü (n8n) veya bir HTTP tetikleyicisi (Pipedream) oluşturun, adresini yapıştırın ve aracın alanları öğrenmesi için “Test gönder”e basın.

İmzalama anahtarımı kaybettim.

İşletme sahibi onu uç noktadan yeniden görüntüleyebilir ya da yenileyebilir. Yenilemek hemen yeni bir anahtar oluşturur ve eskisi çalışmayı bırakır.

Bu yazı yardımcı oldu mu?

Sorunuzu yanıtlamadı mı?

Bize yazın ve hangi sayfada olduğunuzu belirtin. Her mesajı bir insan okur ve yanıt, yazdığınız dilde gelir.

Bize yazın