Вебхуктар, серверден серверге постбэктер жана REST API

TapTime'ды башка системаларга туташтыруунун үч жолу, баары бир бөлүмдө. Аларды компаниянын ээси гана башкара алат. Чаттагы билдирүүлөр жана Zapier, Make, n8n же Pipedream үчүн өзүнчө нускамаларды караңыз — алар ошол эле окуяларды колдонот.

Панель Интеграциялар Вебхуктар жана API

Эмнени колдонуу керек	Качан
Вебхук	Өз системаңыз же CRM ар бир брондоо, буйрутма же ишенимдүүлүктөгү өзгөрүү тууралуу бардык маалыматы менен билиши керек.
Постбэк	Жарнама тармагы, өнөктөштүк программа же трекер ар бир конверсияда чакыруу үчүн постбэк URL берген.
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=<кол тамга ачкычыңыз менен эсептелген «t.body» HMAC-SHA256 мааниси>. Сурамга ишенүүдөн мурун аны салыштырыңыз.

Сурамдын денеси — JSON: окуянын id'си, түрү жана убактысы, ошондой эле data.booking, data.order же data.loyalty астындагы толук брондоо, буйрутма же ишенимдүүлүк картасы — конок, убакыт, стол, кызмат же позициялар, абалы жана кайдан келгени (UTM тегдери жана клик ID'лери).

Каалаган 2xx абал коду менен жооп бериңиз. Башка каалаган жоопто жөнөтүү болжол менен бир сутка ичинде 8 жолу кайталанат.
Ар бир окуянын id'си бар: аны эки жолу алсаңыз, экинчисине көңүл бурбаңыз.
410 Gone деп жооп берсеңиз, TapTime ошол окуяны кайталоону токтотот.
Кайра багыттоолор аткарылбайт, ал эми жеке тармактардагы даректер кабыл алынбайт.

Серверден серверге постбэктер

Трекер берген постбэк URL'ин коюп, брондоо маалыматтарын кыстаруу үчүн өзгөрмөлөрдү басыңыз, мисалы 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) түзүп, анын дарегин коюңуз да, курал талааларды таанып алышы үчүн «Сыноо жөнөтүү» баскычын басыңыз.

Кол тамга ачкычымды жоготуп алдым.

Ээси аны эндпоинттен кайра көрө алат же жаңылай алат. Жаңылоо дароо жаңы ачкыч берет, ал эми эскиси иштебей калат.

Бул макала пайдалуу болдубу?

Бул суроого жооп бербедиби?

Бизге жазыңыз жана кайсы бетте болгонуңузду көрсөтүңүз. Ар бир катты адам окуйт, жооп сиз жазган тилде келет.

Бизге жазыңыз