Webhook கோரிக்கை கட்டமைப்பைப் புரிந்துகொள்ளுதல்
வெப்ஹூக் (Webhook) என்பது ஒரு கணினியிலிருந்து மற்றொரு கணினிக்கு நிகழ்நேரத் தரவை அனுப்பப் பயன்படும் ஒரு முக்கிய வழியாகும். பொதுவாக, ஒரு நிகழ்வு நிகழும்போது, மூலச் சேவையகம் இலக்குச் சேவையகத்திற்கு HTTP கோரிக்கை ஒன்றை அனுப்புகிறது. இந்த வெப்ஹூக் கோரிக்கைகளின் துல்லியமான வடிவமைப்பு, தலைப்புகள் மற்றும் உள்ளடக்க உடல் (Body) ஆகியவற்றை ஆய்வு செய்வது ஒருங்கிணைப்புப் பணிகளின் போது மிகவும் அவசியமாகிறது.
API உருவாக்குநர்கள் (API developers), ஒருங்கிணைப்புப் பொறியாளர்கள் (Integration engineers), வாடிக்கையாளர் சேவைப் பிரதிநிதிகள் (Customer service representatives) மற்றும் தானியங்கி பராமரிப்பாளர்கள் (Automation maintainers) ஆகியோர் வெப்ஹூக் கோரிக்கைகளைச் சரிபார்க்கவும், உள்ளூர் சூழலில் அவற்றைச் சோதிக்கவும் இந்த Webhook கோரிக்கை ஆய்வாளர் கருவியைப் பயன்படுத்துகின்றனர்.
உள்ளீட்டு அளவுருக்கள் மற்றும் கட்டுப்பாடுகள்
இந்தக் கருவியைப் பயன்படுத்த, கைப்பற்றப்பட்ட வெப்ஹூக் கோரிக்கையின் விவரங்களை பின்வரும் உள்ளீட்டுப் புலங்களில் வழங்க வேண்டும்:
- முறை: வெப்ஹூக் அனுப்பப்பட்ட HTTP முறையைத் தேர்ந்தெடுக்க வேண்டும். இதில் POST, PUT, PATCH, GET, DELETE ஆகிய முறைகள் ஆதரிக்கப்படுகின்றன.
- தலைப்புகள்:
தலைப்புகள்புலத்தில், ஒரு வரிக்கு ஒரு தலைப்பு வீதம் "Name: value" என்ற வடிவத்தில் உள்ளிட வேண்டும்.- அதிகபட்சமாக 200 வெற்று அல்லாத தலைப்பு வரிகள் மட்டுமே அனுமதிக்கப்படும்.
- தலைப்புகளின் மொத்த நீளம் 100,000 எழுத்துகளுக்குள் இருக்க வேண்டும்.
- உடல் (Body):
உடல்புலத்தில், எந்தவொரு சர்வர் பக்க பாகுபடுத்தலுக்கும் (server-side parsing) முன் எடுக்கப்பட்ட சரியான மூலப்பொருளை (raw body) அப்படியே ஒட்ட வேண்டும்.- உடலின் அதிகபட்ச நீளம் 1,000,000 எழுத்துகளுக்கு மிகாமல் இருக்க வேண்டும்.
வெளியீட்டு முடிவுகள்
உள்ளீடுகளை வழங்கி, "கோரிக்கையை ஆய்வு செய்யவும்" பொத்தானை அழுத்திய பின், கருவி பின்வரும் வெளியீடுகளை வழங்குகிறது:
- வடிவமைக்கப்பட்ட உடல்: உள்ளீடு JSON அல்லது URL-குறியீடு செய்யப்பட்ட படிவத் தரவாக (URL-encoded form data) இருந்தால், அது எளிதாகப் படிக்கும் வகையில் வடிவமைக்கப்பட்டு காட்டப்படும். உள்ளடக்க உடல் எதுவும் இல்லை எனில், அது
(காலியான உடல்)என்று காண்பிக்கும். - கையொப்ப புலங்கள்: கோரிக்கையில் உள்ள பொதுவான கையொப்பங்கள் அல்லது வெப்ஹூக் நேர முத்திரை (timestamp) தலைப்புகள் கண்டறியப்பட்டு பட்டியலிடப்படும். அத்தகைய தலைப்புகள் எதுவும் இல்லை எனில்,
பொதுவான கையொப்பம் அல்லது வெப்ஹூக் நேர முத்திரை தலைப்பு எதுவும் காணப்படவில்லை.என்ற செய்தி காட்டப்படும். - உள்ளூர் சுருட்டை சோதனை: உங்கள் உள்ளூர் கணினியில் இந்த வெப்ஹூக்கைச் சோதிப்பதற்காக,
http://localhost:3000/webhooksஎன்ற முகவரியை இலக்காகக் கொண்ட, ஷெல்-மேற்கோளிடப்பட்ட (shell-quoted) cURL கட்டளை உருவாக்கப்படும். இதை நகலெடுத்து உங்கள் முனையத்தில் (Terminal) நேரடியாகப் பயன்படுத்தலாம்.
செயலாக்க விதிகள் மற்றும் பிழைச் செய்திகள்
- JSON மற்றும் படிவத் தரவு கண்டறிதல்: இக்கருவி JSON மற்றும் URL-encoded படிவ உடல்களைத் தானாகவே கண்டறிந்து வடிவமைக்கிறது. பிற உடல் வகைகள் எளிய உரையாகவே (plain text) கையாளப்படும்.
- JSON பாகுபடுத்தல் விதி: JSON உடல்கள்
JSON.parseகொண்டு பாகுபடுத்தப்பட்டு, பின்னர் மறுசீரமைக்கப்படுகின்றன. இதனால், மூலக் கோப்பில் இருந்த அசல் இடைவெளிகள் (whitespace) மற்றும் புலங்களின் வரிசை அமைப்பு மாறக்கூடும். - கையொப்பக் கண்டறிதல் வரம்பு: இக்கருவி
signature,hmac,digestமற்றும் பொதுவான நேர முத்திரை பெயர்களைக் கொண்டு மட்டுமே தலைப்புகளை அடையாளம் காண்கிறது. இது HMAC கணக்கீடுகளையோ, அல்காரிதம் சரிபார்ப்பையோ, மூல பைட்டுகளின் சரிபார்ப்பையோ அல்லது ரகசிய விசை (secret key) சரிபார்ப்பையோ செய்யாது.
சாத்தியமான பிழைச் செய்திகள்:
உள்ளீடுகளில் தவறுகள் இருந்தால், பின்வரும் பிழைகள் காட்டப்படும்:
முதலில் குறைந்தபட்சம் ஒரு தலைப்பு அல்லது கோரிக்கை உள்ளடக்கத்தை ஒட்டவும்.இந்தக் கருவிக்கு தலைப்புகள் மிக நீளமாக உள்ளன. தொடர்பில்லாத அல்லது மீண்டும் மீண்டும் மதிப்புகளை அகற்றவும்.இந்த கருவிக்கு உடல் மிக நீளமாக உள்ளது. 1,000,000 எழுத்துகளுக்குக் கீழ் வைக்கவும்.பல தலைப்புக் கோடுகள் உள்ளன. கோரிக்கையை 200 தலைப்புகள் அல்லது அதற்கும் குறைவாக வைத்திருங்கள்.‹line›: தலைப்பு வரி தவறானது. பெயர்: மதிப்பு பயன்படுத்தவும்.உடல் JSON போல் தெரிகிறது ஆனால் பாகுபடுத்த முடியவில்லை.ஃபார்ம் பாடி முழுமையடையாத சதவீத தப்பிப்பைக் கொண்டுள்ளது.
தரவு தனியுரிமை
உங்கள் தரவுப் பாதுகாப்பு எங்களுக்கு முக்கியம். நீங்கள் ஒட்டும் வெப்ஹூக் கோரிக்கையின் விவரங்கள் அனைத்தும் உங்கள் உலாவியிலேயே (browser) செயலாக்கப்படுகின்றன. BroBroGo உங்கள் தரவை எந்தவொரு வெளிப்புற சேவையகத்திற்கும் பதிவேற்றுவதோ அல்லது சேமிப்பதோ இல்லை.
அடிக்கடி கேட்கப்படும் கேள்விகள் (FAQ)
இந்தப் பக்கம் நேரடி வெப்ஹூக் அழைப்பைப் பெற முடியுமா?
இல்லை. கைப்பற்றப்பட்ட கோரிக்கையை ஆய்வுக்காக இங்கே ஒட்டவும். பக்கம் ஒரு பொது இறுதிப்புள்ளியை உருவாக்கவோ, அழைப்புகளைப் பெறவோ அல்லது உருவாக்கப்பட்ட சோதனைக் கோரிக்கையை அனுப்பவோ இல்லை.
எந்த webhook உடல் வடிவங்களை நான் ஆய்வு செய்யலாம்?
JSON மற்றும் URL-குறியீடு செய்யப்பட்ட படிவ உடல்கள் கண்டறியப்பட்டு வடிவமைக்கப்பட்டுள்ளன. மற்ற உடல்கள் எளிய உரையாக இருக்கும், எனவே கருவி XML, மல்டிபார்ட் அல்லது பைனரி உள்ளடக்கத்தை யூகிக்காது.
கையொப்பப் புலத்தைக் கண்டறிவது கோரிக்கை உண்மையானது என்பதை நிரூபிக்கிறதா?
இல்லை. கருவி கையொப்பம் மற்றும் தொடர்புடைய நேரமுத்திரை தலைப்புகளை மட்டுமே பரப்புகிறது. கையொப்பப் புலம் இருப்பதாலேயே கோரிக்கை உண்மையானது என்று உறுதியாகிவிடாது — உண்மையான சரிபார்ப்பிற்கு அனுப்புநரின் சரியான கையொப்ப விதிகள், இரகசிய அல்லது பொது விசை மற்றும் அசல் கோரிக்கை பைட்டுகள் தேவை.