የዌብሆክ ጥያቄ መዋቅርን መረዳት
የዌብሆክ (Webhook) ጥያቄዎች ከአንድ መተግበሪያ ወደ ሌላ መተግበሪያ መረጃን በቅጽበት ለማስተላለፍ የሚረዱ የኤችቲቲፒ (HTTP) ጥያቄዎች ናቸው። እነዚህን ጥያቄዎች በትክክል ለመረዳትና ለመጠቀም የጥያቄውን ዘዴ፣ የራስጌዎችን ይዘት እና ዋናውን የጥያቄ አካል (Body) በጥንቃቄ መመርመር ያስፈልጋል።
የዌብሆክ ጥያቄ መርማሪ የተያዘን የዌብሆክ ጥያቄ አወቃቀር ለመተንተን፣ የሰውነት ቅርጸቱን ለመረዳት እና የተለመዱ የፊርማ ወይም የጊዜ ማህተም ራስጌዎች መኖራቸውን ለማረጋገጥ የሚረዳ መገልገያ ነው። ይህ መሳሪያ የጥያቄውን ይዘት በመመርመር ለአካባቢ ሙከራ የሚሆን የ cURL ትዕዛዝ ያመነጫል።
የግብዓት መረጃዎች እና ገደቦች
መሳሪያው የዌብሆክ ጥያቄን በትክክል ለመተንተን የሚከተሉትን ግብዓቶች ይቀበላል፦
- ዘዴ፦ ከዝርዝሩ ውስጥ የሚመረጥ የኤችቲቲፒ ዘዴ ሲሆን POST፣ PUT၊ PATCH፣ GET፣ ወይም DELETE ሊሆን ይችላል።
- ራስጌዎች፦ በአንድ መስመር አንድ ራስጌ በ "Name: value" ቅርጸት መግባት አለበት። ለዚህ ግብዓት ከፍተኛው ገደብ 200 ባዶ ያልሆኑ የራስጌ መስመሮች እና 100,000 ቁምፊዎች ነው።
- አካል (Body)፦ ማናቸውም የአገልጋይ ወገን ትንተና ከመደረጉ በፊት የተያዘው ትክክለኛው ጥሬ አካል መሆን አለበት። ከፍተኛው የቁምፊ ገደብ 1,000,000 ቁምፊዎች ነው።
የውጤት መረጃዎች ትንተና
ግብዓቶቹ ከተመረመሩ በኋላ መሳሪያው የሚከተሉትን ውጤቶች ያሳያል፦
- የተቀረጸ አካል፦ የጥያቄው አካል JSON ወይም በ URL-የተመሰጠረ የቅጽ ውሂብ (URL-encoded form data) ከሆነ ተለይቶ በቅርጸት ይቀርባል። የጥያቄው አካል ባዶ ከሆነ "(ባዶ አካል)" የሚል ጽሑፍ ይታያል።
- የፊርማ ቦታዎች፦ በጥያቄው ውስጥ የተካተቱ የተለመዱ የፊርማ ወይም የዌብሆክ የጊዜ ማህተም ራስጌዎች ዝርዝር ይወጣል። ምንም ዓይነት የተለመደ የፊርማ ወይም የጊዜ ማህተም ራስጌ ካልተገኘ "ምንም የጋራ ፊርማ ወይም የዌብ መንጠቆ የጊዜ ማህተም ራስጌ አልተገኘም።" የሚል መልዕክት ይታያል።
- የአካባቢው የCURL ሙከራ፦ ለአካባቢው የልማት አካባቢ ሙከራ የሚረዳ እና ወደ
http://localhost:3000/webhooksአድራሻ የሚመራ በሼል የተጠቀሰ የ cURL ትዕዛዝ ይፈጠራል።
የአሰራር ደንቦች እና ልዩ ሁኔታዎች
መሳሪያው ግብዓቶችን በሚተነትንበት ጊዜ የሚከተሉትን ደንቦች ይከተላል፦
- የቅርጸት መለየት፦ መሣሪያው JSON እና URL-የተመሰጠሩ የቅጽ አካላትን በራስ-ሰር ለይቶ ይቀርጻል። ከእነዚህ ውጪ ያሉ ሌሎች የሰውነት ዓይነቶች ሳይለወጡ እንደ ግልጽ ጽሑፍ ይቆያሉ።
- የJSON ትንተና፦ የJSON አካላት በ
JSON.parseበኩል ተተንትነው በድጋሚ የሚደራጁ በመሆኑ፣ በዋናው ጥያቄ ላይ የነበሩ ክፍት ቦታዎች (whitespace) እና የሜዳዎች ቅደም ተከተል ሊቀየሩ ይችላሉ። - የcURL ትዕዛዝ፦ የሚመነጨው የ cURL ትዕዛዝ ሁልጊዜም ወደ ቋሚው
http://localhost:3000/webhooksአድራሻ የሚመራ ነው። - የፊርማ መለየት፦ የፊርማ እና የጊዜ ማህተም ራስጌዎች የሚለዩት እንደ
signature፣hmac፣digestእና የተለመዱ የጊዜ ማህተም የስም ቅጦችን በመፈለግ ብቻ ነው። መሳሪያው የ HMAC ስሌትን አይሰራም፣ አልጎሪዝምን አያሄድም፣ የመጀመሪያውን የጥያቄ ባይቶች ወይም ሚስጥራዊ ቁልፍ አያረጋግጥም፣ እንዲሁም የጊዜ ገደብ (replay window) ወይም የሰጪ-ተኮር ማረጋገጫዎችን አይሰራም።
በሂደቱ ወቅት ስህተቶች ካጋጠሙ የሚከተሉት የስህተት መልዕክቶች ሊታዩ ይችላሉ፦
- "ቢያንስ አንድ ራስጌ ወይም ጥያቄ አካል ለጥፍ።"
- "ራስጌዎች ለዚህ መሳሪያ በጣም ረጅም ናቸው። ያልተዛመዱ ወይም ተደጋጋሚ እሴቶችን ያስወግዱ።"
- "ሰውነቱ ለዚህ መሳሪያ በጣም ረጅም ነው። ከ1,000,000 ቁምፊዎች በታች ያቆዩት።"
- "የራስጌ መስመሮች በጣም ብዙ ናቸው። ጥያቄውን ወደ 200 ራስጌዎች ወይም ከዚያ በታች ያቆዩት።"
- "
‹line›: የራስጌ መስመር ልክ ያልሆነ ነው። ተጠቀም ስም: እሴት." - "አካሉ JSON ይመስላል ግን ሊተነተን አልቻለም።"
- "የቅርጹ አካል ያልተሟላ በመቶ ማምለጫ ይዟል።"
የውሂብ ግላዊነት አያያዝ
የተለጠፈ ጥያቄዎ በአሳሽዎ ውስጥ ይቆያል። BroBroGo አይጭነውም ወይም አያስቀምጥም። ሁሉም የትንተና እና የቅርጸት ስራዎች የሚከናወኑት በኮምፒውተርዎ አሳሽ ውስጥ ብቻ ነው።
ይህ መሳሪያ ለማን ያስፈልጋል?
ይህ መሳሪያ በተለይ ለሚከተሉት ባለሙያዎች ጠቃሚ ነው፦
- የኤፒአይ (API) አልሚዎች
- የስርዓት ውህደት መሐንዲሶች (Integration engineers)
- የደንበኞች አገልግሎት ተወካዮች
- የአውቶሜሽን ስርዓት ተንከባካቢዎች
ተደጋግመው የሚጠየቁ ጥያቄዎች (FAQ)
ይህ ገጽ የቀጥታ የድር መንጠቆ መልሶ ጥሪ ሊቀበል ይችላል?
አይ. ለምርመራ የተያዘ ጥያቄ እዚህ ይለጥፉ። ገጹ ይፋዊ የመጨረሻ ነጥብ አይፈጥርም ፣ መልሶ ጥሪዎችን አይቀበልም ወይም የተፈጠረውን የሙከራ ጥያቄ አይልክም።
የፊርማ ቦታ ማግኘቱ ጥያቄው ትክክለኛ መሆኑን ያረጋግጣል?
አይ። መሣሪያው ፊርማዎችን እና ተዛማጅ የጊዜ ማህተም ራስጌዎችን ብቻ ነው የሚያቀርበው። ትክክለኛ ማረጋገጫ የላኪውን ትክክለኛ የፊርማ ህጎች፣ ሚስጥራዊ ወይም ይፋዊ ቁልፍ እና ዋናውን የመጠየቅ ባይት ይፈልጋል። የፊርማ መስክ ማግኘት ጥያቄው ትክክለኛ መሆኑን አያረጋግጥም — እውነተኛ ማረጋገጫ የላኪውን የፊርማ ደንቦች፣ ምስጢር ወይም ቁልፍ እና የመጀመሪያውን የጥያቄ ባይቶች ይፈልጋል።
የትኞቹን የድር መንጠቆ የሰውነት ቅርጸቶችን መመርመር እችላለሁ?
JSON እና URL-የተመሰጠሩት ቅጽ አካላት ተገኝተው ተቀርፀዋል። መሳሪያው በኤክስኤምኤል፣ በባለብዙ ክፍል ወይም በሁለትዮሽ ይዘት ላይ እንዳይገመት ሌሎች አካላት እንደ ግልፅ ጽሑፍ ይቆያሉ።