Webhooklar, serverdan serverga postbacklar va REST API

TapTime'ni boshqa tizimlarga ulashning uchta usuli, hammasi bitta boʻlimda. Ularni faqat kompaniya egasi boshqara oladi. Chat bildirishnomalari hamda Zapier, Make, n8n yoki Pipedream uchun ularning alohida qoʻllanmalariga qarang — ular ham xuddi shu hodisalardan foydalanadi.

Panel Integratsiyalar Webhooklar va API

Nima	Qachon
Webhook	Oʻz tizimingiz yoki CRM har bir bandlov, buyurtma yoki sodiqlik oʻzgarishidan barcha tafsilotlari bilan xabardor boʻlishi kerak.
Postback	Reklama tarmogʻi, hamkor yoki treker sizga har bir konversiyada chaqiriladigan postback URL bergan.
REST API	Tizimingiz bandlovlarni xohlagan paytda olishni yoki ularni tasdiqlash va bekor qilishni istaydi.

Yuborish mumkin boʻlgan hodisalar

Hodisa	Qachon
booking.requested	Mehmon tasdiqlashingizni kutadigan bandlov soʻradi
booking.confirmed	Bandlov tasdiqlandi
booking.cancelled	Mehmon yoki muassasa bekor qildi
booking.no_show	Mehmon kelmadi
booking.completed	Tashrif yakunlandi
order.placed	Mehmonning buyurtmasi sizga yetib keldi (sahifangizdan yoki stoldagi QR koddan)
order.paid	Istalgan buyurtma toʻlandi, jumladan kassada ham
loyalty.member_joined	Mijoz dasturda birinchi muhrini oldi
loyalty.stamp_added	Muhr qoʻshildi
loyalty.reward_issued	Karta toʻldi va mukofot chiqarildi
loyalty.reward_redeemed	Mukofot berildi

Webhooklar

1
Webhook qoʻshish
Endpointingizning https manzilini qoʻying va hodisalarni tanlang — bandlovlar, buyurtmalar, sodiqlik yoki hammasi.
2
Sinov yuborish
Namuna hodisa darhol yuboriladi va endpointingiz bergan javob koʻrsatiladi.
3
Imzoni tekshiring
Har bir soʻrovda TapTime-Signature sarlavhasi boʻladi: t=<time>,v1=<imzo kalitingiz bilan hisoblangan “t.body” HMAC-SHA256 qiymati>. Soʻrovga ishonishdan oldin imzoni solishtiring.

Soʻrov tanasi JSON formatida: hodisa ID'si, turi va vaqti hamda data.booking, data.order yoki data.loyalty ostida butun bandlov, buyurtma yoki sodiqlik kartasi — mehmon, vaqt, stol, xizmat yoki tarkib, holat va u qayerdan kelgani (UTM teglari va click ID'lar) bilan.

Istalgan 2xx holat kodi bilan javob bering. Boshqa javoblarda taxminan bir kun davomida 8 marta qayta uriniladi.
Har bir hodisaning ID'si bor: bir hodisani ikki marta olsangiz, ikkinchisini eʼtiborsiz qoldiring.
410 Gone bilan javob bersangiz, TapTime bu hodisani qayta yuborishni toʻxtatadi.
Qayta yoʻnaltirishlarga amal qilinmaydi, xususiy tarmoqlardagi manzillar esa rad etiladi.

Serverdan serverga postbacklar

Trekeringiz bergan postback URL'ni qoʻying va bandlov maʼlumotlarini qoʻshish uchun oʻzgaruvchilarni bosing, masalan https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Mavjud oʻzgaruvchilar orasida {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} va {fbclid} bor. Trekerning click ID qiymati bandlov havolangizda click_id, clickid yoki subid boʻlsa, bandlovga yetib keladi.

REST API

1
API kaliti yaratish
Unga nom bering va faqat oʻqish yoki tasdiqlash, bekor qilish va “Kelmadi” deb belgilashga ruxsat beruvchi oʻqish va yozish rejimini tanlang.
2
Hoziroq nusxalab oling
Kalit faqat bir marta koʻrsatiladi. Uni serveringizda saqlang — hech qachon veb-sahifa yoki ilovada emas.
3
API'ga murojaat qiling
Kalitni Authorization: Bearer <key> sifatida https://api.tapti.me/v1/company manziliga yuboring.

Soʻrov	Nima qaytaradi
GET /v1/company	Kalit tegishli boʻlgan kompaniya
GET /v1/company/reservations, /appointments	status, branchId, from, to yoki updatedSince boʻyicha filtrlangan bandlovlar, sahifada 100 tadan
GET /v1/company/reservations/{id}	Bitta bandlov
POST /v1/company/reservations/{id}/status	Holatni oʻzgartiradi (yozish kalitlari)
GET /v1/company/orders, /orders/{id}	status, source, fulfilment, from, to yoki paidSince boʻyicha filtrlangan buyurtmalar, tarkibi va summalari bilan
GET /v1/company/loyalty/programs, /cards, /rewards	Sodiqlik dasturlari, aʼzolar kartalari va ular qoʻlga kiritgan mukofotlar
GET /v1/company/events?after={cursor}	Barcha bandlov, buyurtma va sodiqlik hodisalari tartib bilan — sinxron turish uchun muntazam soʻrab turing; faqat ayrimlari uchun type=order,loyalty qoʻshing
POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id}	URL'ni hodisalarga obuna qiladi va obunani bekor qiladi — Zapier, Make, n8n va Pipedream ilovalari shundan foydalanadi

Nimadir ishlamasa

Har bir endpointning Yuborishlar jurnali oxirgi 25 ta yuborishni holat kodi va tizimingiz bergan javob bilan koʻrsatadi. Muvaffaqiyatsiz yuborishlar oʻzi qayta uriniladi; “Qayta yuborish” bittasini hozir takrorlaydi.

Koʻp beriladigan savollar

Webhookni Zapier yoki Make'ga yuborsa boʻladimi?

Ha — Integratsiyalar → Avtomatlashtirish boʻlimidan foydalaning: u manzil platformaga tegishli ekanini tekshiradi va platformaning oʻz qadamlarini koʻrsatadi. “Catch hook” (Zapier), “Custom webhook” (Make), Webhook node (n8n) yoki HTTP trigger (Pipedream) yarating, uning manzilini qoʻying va vosita maydonlarni oʻrganishi uchun “Sinov yuborish” tugmasini bosing.

Imzo kalitimni yoʻqotib qoʻydim.

Egasi uni endpointdan qayta koʻrishi yoki yangilashi mumkin. Yangilash darhol yangi kalit chiqaradi, eskisi esa ishlashdan toʻxtaydi.

Bu maqola foydali boʻldimi?

Bu savolingizga javob bermadimi?

Bizga yozing va qaysi sahifada boʻlganingizni koʻrsating. Har bir xabarni odam oʻqiydi va javob siz yozgan tilda keladi.

Bizga yozing