Event
Payment, game session, KYC check, bonus, player profile அல்லது மற்ற object-ல் ஏற்பட்ட change-ன் record.
Documentation / Webhooks
Webhooks மற்றும் event delivery
Message creation மற்றும் signature verification முதல் receipt acknowledgement, redelivery மற்றும் error monitoring வரை systems இடையே reliable status மற்றும் event delivery அமைக்கவும்.
Events
Statuses மற்றும் changes
Signature
Authenticity verification
Retries
Redelivery
Monitoring
History மற்றும் diagnostics
Event flow
Creation முதல் acknowledgement வரை
01
Event உருவாக்கவும்
Identifier, type, time, object, status மற்றும் related data-ஐ குறிப்பிடவும்.
02
Sign செய்து அனுப்பவும்
Event-ஐ HTTPS மூலம் signature மற்றும் limited timeout உடன் அனுப்பவும்.
03
Receipt-ஐ acknowledge செய்யவும்
Verification பிறகு event-ஐ store செய்து உடனடியாக successful HTTP response திருப்பவும்.
04
Error வந்தால் retry செய்யவும்
Delivery-ஐ increasing intervals உடன் retry செய்து undelivered events-ஐ investigation-க்காக சேமிக்கவும்.
Overview
Webhook ஒரு state change-ஐ தெரிவிக்கிறது
Sender delivery-ஐ retry செய்யலாம்; அதனால் recipient source-ஐ verify செய்து receipt-ஐ acknowledge செய்து ஒவ்வொரு event-ஐ ஒரே முறை மட்டுமே apply செய்ய வேண்டும்.
Acknowledgement
Event verify செய்யப்பட்டு நம்பகமாக store செய்யப்பட்ட பிறகு recipient successful HTTP response திருப்புவார்.
Recovery
Redelivery மற்றும் reconciliation இரண்டு systems-ல் ஏதாவது ஒன்று தற்காலிகமாக unavailable ஆன பிறகு data restore செய்ய உதவுகின்றன.
Event structure
Event-ல் என்ன data இருக்க வேண்டும்
Consistent message structure verification, routing, duplicate protection மற்றும் பல event types support-ஐ எளிதாக்குகிறது.
Event identifier
System redelivery-ஐ கண்டறிந்து processing history-ஐ தேட பயன்படுத்தும் unique value.
Event type
என்ன change நடந்தது மற்றும் அதை எவ்வாறு process செய்ய வேண்டும் என்பதை வரையறுக்கும் தெளிவான, stable name.
Creation time
Agreed format மற்றும் time zone-ல் event உருவாக்கப்பட்ட date மற்றும் time.
Related object
Payment, player, round, request, bonus அல்லது மற்ற object-ன் type மற்றும் identifier.
Schema version
Version number active integrations-ஐ பாதிக்காமல் message structure-ஐ பாதுகாப்பாக மாற்ற உதவுகிறது.
Operation correlation
Original request, transaction, session அல்லது related actions chain-ன் identifier.
Context
Correct routing-க்கு தேவையான brand, project, market, environment, provider மற்றும் பிற data.
Event data
Change-ஐ process செய்ய அல்லது பின்னர் API request செய்ய தேவையான minimum fields set.
Signature மற்றும் verification
Event authenticity மற்றும் integrity verification
Data மாற்றுவதற்கு முன் recipient secure connection, signature, creation time மற்றும் unique event identifier-ஐ verify செய்ய வேண்டும்.
01
Raw message-ஐ capture செய்யவும்
JSON format மாற்றுவதற்கு முன் raw request body-க்கு எதிராக signature-ஐ verify செய்யவும்.
02
Timestamp-ஐ check செய்யவும்
Event time permitted window-க்கு வெளியே இருந்தால் request-ஐ reject செய்யவும்.
03
Signature-ஐ verify செய்யவும்
Agreed secret மற்றும் HMAC அல்லது digital-signature algorithm பயன்படுத்தவும்.
04
Identifier-ஐ check செய்யவும்
Event ஏற்கனவே apply செய்யப்படவில்லை என்பதை confirm செய்து verification result-ஐ store செய்யவும்.
Delivery மற்றும் retries
HTTP responses மற்றும் redelivery
Sender successful receipt, temporary error மற்றும் permanent failure-ஐ வேறுபடுத்த வேண்டும்; recipient விரைவாகவும் தெளிவாகவும் response அளிக்க வேண்டும்.
Successful HTTP response
Event verify செய்யப்பட்டு further processing-க்காக நம்பகமாக store செய்யப்பட்டதை confirm செய்கிறது.
Limited timeout
Sender-க்கு response அளிப்பதற்கு முன் நீண்ட processing செய்ய வேண்டாம் — event-ஐ முதலில் store செய்யவும்.
Redelivery
Temporary network error, unavailability அல்லது no response ஏற்பட்டால் delivery-ஐ retry செய்யவும்.
Increasing retry interval
Additional load உருவாகாமல் attempts இடையிலான delay-ஐ படிப்படியாக அதிகரிக்கவும்.
Undelivered event queue
அனைத்து attempts முடிந்த பிறகு event-ஐ diagnostics மற்றும் manual handling-க்காக சேமிக்கவும்.
Manual redelivery
Operator புதிய operation உருவாக்காமல் தேர்ந்தெடுத்த event-ஐ மீண்டும் அனுப்ப முடியும்.
Delivery monitoring
Attempts எண்ணிக்கை, responses, latest error மற்றும் next delivery time-ஐ track செய்யவும்.
Alerts
Errors அதிகரிக்கும் போது, retries முடியும் போது அல்லது queue-ல் events சேரும்போது team-க்கு alert செய்யவும்.
Event processing
Duplicate protection மற்றும் status ordering
Recipient single delivery அல்லது strict event ordering-ஐ நம்பக்கூடாது.
ஒரே முறை மட்டுமே apply செய்யவும்
Data மாற்றுவதற்கு முன் event identifier-ஐ store செய்யவும்.
Repeated event-ஐ மற்றொரு debit, credit அல்லது state change இல்லாமல் acknowledge செய்யவும்.
Event-ஐ object மற்றும் அதன் current state-ுடன் link செய்யவும்.
Event மற்றும் business change-ஐ ஒரே consistent operation ஆக store செய்யவும்.
Ordering மற்றும் freshness
Timestamp, sequence number அல்லது event version-ஐ compare செய்யவும்.
Older event தாமதமாக வந்தால் object-ஐ outdated state-க்கு திருப்ப வேண்டாம்.
Valid status transitions மட்டும் அனுமதிக்கவும்.
சந்தேகம் இருந்தால் API மூலம் current object state-ஐ request செய்யவும்.
Testing
Launch முன் என்ன test செய்ய வேண்டும்
Successful delivery, invalid signatures, duplicates, slow responses, out-of-order events மற்றும் failure பிறகு recovery-ஐ test செய்யவும்.
Invalid signature
Modified message, unknown key, expired timestamp மற்றும் unsupported algorithm.
Redelivery
Processing complete ஆகும் முன்பும் பின்பும் அதே event பலமுறை வருகிறது.
Slow response
Recipient response அளிக்க அதிக நேரம் எடுக்கலாம், connection drop ஆகலாம் அல்லது acknowledgement sender-ஐ அடையாமல் போகலாம்.
Out-of-order processing
Final status intermediate status-க்கு முன் வரலாம்; older event newer event-க்கு பிறகு deliver ஆகலாம்.
Unavailable endpoint
HTTP 5xx errors, DNS, TLS, rate limits மற்றும் retry attempts முழுமையாக முடியும் நிலை ஆகியவற்றை test செய்யவும்.
Delivery history
Event identifier மூலம் அனைத்து attempts, responses, errors மற்றும் manual redelivery results தேடக்கூடியதாக இருக்க வேண்டும்.
Pre-launch checklist
Security, duplicate protection, redelivery மற்றும் error monitoring verify செய்யப்பட்ட பிறகே production delivery enable செய்யப்பட வேண்டும்.
Test மற்றும் production environments வெவ்வேறு endpoints மற்றும் signing secrets பயன்படுத்த வேண்டும்.
Signature raw message மற்றும் அதன் creation time-க்கு எதிராக verify செய்யப்பட வேண்டும்.
Event identifier store செய்யப்பட்டு operations ஒருமுறைக்கு மேல் execute ஆகாமல் பாதுகாக்க வேண்டும்.
Event store செய்த பிறகு recipient விரைவாக successful HTTP response திருப்ப வேண்டும்.
Retries, increasing intervals மற்றும் manual redelivery configure செய்யப்பட்டிருக்க வேண்டும்.
Delivery history மற்றும் identifier-based search support team-க்கு கிடைக்க வேண்டும்.
Reliable event delivery அமைக்க வேண்டுமா?
Event list, receiving endpoints மற்றும் status transition rules-ஐ வழங்குங்கள். Message structure, signature verification, redelivery மற்றும் error monitoring வரையறுக்க APIACE உதவும்.