IOSOR

IOSOR Знање

Потпис вебхука и прозор понављања: идемпотентност да 02:00 остане досадно

Проверите потписе, ограничите прозор понављања и учините улазне вебхукове идемпотентнима — никад не примајте непотписане callback, никад не дебитирајте prepaid двапут на retry.

Непотписани callback није догађај. То је неаутентиковани HTTP који случајно изгледа као ваш payload. Тимови који «прво прихвате, касније провере» плаћају у 02:00: поновљени DLR, дуплирани STOP или други дебит новчаника који finance не може вратити. Prepaid чини грешку видљивом у новцу. Досадне навике: потпис на сваком захтеву, ограничени прозор понављања, кључеви идемпотентности које finance чита уз ред ledgera.

IOSOR очекује ревидибилне B2B интеграције: потписани вебхукови, ротабилне тајне, client-safe грешке без туђих марки. Близу USD 1,000+ месечне употребе ID корелације и доказ понављања постају материјал комерцијалног прегледа. Парирајте са вебхукови и кључеви при покретању и вебхукови који преживе покретање.

Непотписани callback нису догађаји

Проверите потпис пре него парсирате пословна поља. Одбијте недостајуће, истекле или криве потписе client-safe грешком — не обрађујте «ипак за пилота». Staging потрошач који прескаче проверу тренира производњу да прескаче. Каталог live порука не значи да је URL вебхука јавно одлагалиште. Ако не докажете ко је потписао тело, немате догађај; имате кривотворени захтев.

Прозори понављања и зашто се дешава 02:00

Испорука бар-једном retried на timeout, 5xx и двосмислени губитак мреже. Касни retry у 02:00 је нормалан. Прозор ограничава колико дуго потписани payload остаје прихватљив: преширок и нападач понавља стари STOP; претесан и легитимни retry изгледа као кривотворина. Бележите одбијања прозора одвојено од грешака потписа. Погледајте понављања долазног вебхука. Одговорите брзо, persistirajte прво, обрадите async — handler који ради CRM пре ACK производи дупликате.

Идемпотентност коју finance може читати

Исти ID догађаја мора дати исто крајње стање. Извуците ID догађаја/поруке платформе — не измишљајте кључ из временског печата плус тела. Вратите успех на познатом ID без поновног дебита. Одлазне пошиљке требају исту дисциплину — идемпотентност, понављања и новац. Finance мора објаснити сваки prepaid ред наспрам статусног догађаја. Ако timeout изазове олују retry клијента, ledger показује штету први. Каталог in setup није изговор да прескочите идемпотентност «до Live».

Ротација потписа без хаоса двоструког прихватања

Ротирајте тајне без прозора у којем се стари и нови потписи прихватају заувек. Планирајте преклапање, затим режите. Никад не лепите производну тајну у тикет. Одвојите sandbox и производне потрошаче. Dead-letter са алатима понављања да ops може поново возити неуспелог потрошача без измишљања другог дебита. Носите ID корелације од слања до реда ledgera да 02:00 буде runbook, не археологија.

Црвене заставе

  • Handler прима непотписана тела «засад»
  • Нема прозора понављања, или један мерен у недељама
  • Препис статуса без поређења печата
  • Нуспојаве CRM/е-поште пре ACK
  • Производна тајна у ћаскању
  • Дуплирани ID догађаја прошлог месеца без надзора
  • Грешке клијенту које сипају сирове upstream кодове

Počnite sa IOSOR-om

Otvorite IOSOR konzolu i proverite podešavanja aktivne veb-kuk tačke za dolazne potvrde isporuke i povratne pozive događaja. Podesite strog vremenski prozor od pet minuta za proveru potpisa i povežite obrađivač isključivo sa ID-jem platforme. Testirajte krajnju tačku sa ponovljenim sadržajima u fazi pripreme kako biste osigurali da duplikati vraćaju status 200 OK bez pokretanja suvišne poslovne logike.

Резиме IOSOR

Неверификовани руковаоци веб-хука и недостајући прозори понављања претварају мрежне покушаје у дуплиране промене стања. Проверите UTC временску ознаку у console интерфејсу и подесите idempotencija кључ кроз ledger пре него што покренете export за потпуно предвидив рад система.

Да ли је овај водич био корistan?

Повезани водичи