[{"data":1,"prerenderedAt":361},["ShallowReactive",2],{"navigation":3,"\u002Fguides\u002Fpreventing-duplicates":176,"\u002Fguides\u002Fpreventing-duplicates-surround":356},[4,40,100,152],{"title":5,"path":6,"stem":7,"children":8,"icon":39},"Getting started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,11,15,19,23,27,31,35],{"title":10,"path":6,"stem":7},"Introduction",{"title":12,"path":13,"stem":14},"How Postvia works","\u002Fgetting-started\u002Fhow-it-works","1.getting-started\u002F2.how-it-works",{"title":16,"path":17,"stem":18},"First customer and website","\u002Fgetting-started\u002Ffirst-customer-and-website","1.getting-started\u002F3.first-customer-and-website",{"title":20,"path":21,"stem":22},"Create your first form","\u002Fgetting-started\u002Ffirst-form","1.getting-started\u002F4.first-form",{"title":24,"path":25,"stem":26},"Submit your first JSON request","\u002Fgetting-started\u002Ffirst-json-request","1.getting-started\u002F5.first-json-request",{"title":28,"path":29,"stem":30},"Email notifications","\u002Fgetting-started\u002Femail-notifications","1.getting-started\u002F6.email-notifications",{"title":32,"path":33,"stem":34},"Test integration","\u002Fgetting-started\u002Ftest-integration","1.getting-started\u002F7.test-integration",{"title":36,"path":37,"stem":38},"Deploy integration","\u002Fgetting-started\u002Fdeploy-integration","1.getting-started\u002F8.deploy-integration","i-lucide-rocket",{"title":41,"icon":42,"path":43,"stem":44,"children":45},"Guides","i-lucide-book-open","\u002Fguides","2.guides",[46,48,52,56,60,64,68,72,76,80,84,88,92,96],{"title":41,"path":43,"stem":47},"2.guides\u002Findex",{"title":49,"path":50,"stem":51},"JavaScript integration","\u002Fguides\u002Fjavascript","2.guides\u002F1.javascript",{"title":53,"path":54,"stem":55},"Rate limits and retries","\u002Fguides\u002Frate-limits-retries","2.guides\u002F10.rate-limits-retries",{"title":57,"path":58,"stem":59},"Multiple recipients","\u002Fguides\u002Fmultiple-recipients","2.guides\u002F11.multiple-recipients",{"title":61,"path":62,"stem":63},"Success redirects","\u002Fguides\u002Fsuccess-redirects","2.guides\u002F12.success-redirects",{"title":65,"path":66,"stem":67},"Troubleshooting delivery","\u002Fguides\u002Ftroubleshooting-delivery","2.guides\u002F13.troubleshooting-delivery",{"title":69,"path":70,"stem":71},"TypeScript integration","\u002Fguides\u002Ftypescript","2.guides\u002F2.typescript",{"title":73,"path":74,"stem":75},"Nuxt 4 integration","\u002Fguides\u002Fnuxt","2.guides\u002F3.nuxt",{"title":77,"path":78,"stem":79},"Vue integration","\u002Fguides\u002Fvue","2.guides\u002F4.vue",{"title":81,"path":82,"stem":83},"Standard HTML forms","\u002Fguides\u002Fhtml-forms","2.guides\u002F5.html-forms",{"title":85,"path":86,"stem":87},"Turnstile integration","\u002Fguides\u002Fcloudflare-turnstile","2.guides\u002F6.cloudflare-turnstile",{"title":89,"path":90,"stem":91},"Validation errors","\u002Fguides\u002Fvalidation-errors","2.guides\u002F7.validation-errors",{"title":93,"path":94,"stem":95},"Successful submissions","\u002Fguides\u002Fsuccessful-submissions","2.guides\u002F8.successful-submissions",{"title":97,"path":98,"stem":99},"Prevent duplicates","\u002Fguides\u002Fpreventing-duplicates","2.guides\u002F9.preventing-duplicates",{"title":101,"path":102,"stem":103,"children":104,"icon":151},"API reference","\u002Fapi","3.api\u002F1.index",[105,107,111,115,119,123,127,131,135,139,143,147],{"title":106,"path":102,"stem":103},"API overview",{"title":108,"path":109,"stem":110},"Idempotency","\u002Fapi\u002Fidempotency","3.api\u002F10.idempotency",{"title":112,"path":113,"stem":114},"Security and spam protection","\u002Fapi\u002Fsecurity","3.api\u002F11.security",{"title":116,"path":117,"stem":118},"API playground","\u002Fapi\u002Fplayground","3.api\u002F12.playground",{"title":120,"path":121,"stem":122},"Base URLs and versioning","\u002Fapi\u002Fbase-urls-versioning","3.api\u002F2.base-urls-versioning",{"title":124,"path":125,"stem":126},"Submit form","\u002Fapi\u002Fsubmit-form","3.api\u002F3.submit-form",{"title":128,"path":129,"stem":130},"Short alias","\u002Fapi\u002Falias-endpoint","3.api\u002F4.alias-endpoint",{"title":132,"path":133,"stem":134},"Request headers","\u002Fapi\u002Frequest-headers","3.api\u002F5.request-headers",{"title":136,"path":137,"stem":138},"Request body","\u002Fapi\u002Frequest-body","3.api\u002F6.request-body",{"title":140,"path":141,"stem":142},"Response format","\u002Fapi\u002Fresponse-format","3.api\u002F7.response-format",{"title":144,"path":145,"stem":146},"Error codes","\u002Fapi\u002Ferrors","3.api\u002F8.errors",{"title":148,"path":149,"stem":150},"Rate limits","\u002Fapi\u002Frate-limits","3.api\u002F9.rate-limits","i-lucide-code-xml",{"title":153,"icon":154,"path":155,"stem":156,"children":157},"Resources","i-lucide-life-buoy","\u002Fresources","4.resources",[158,160,164,168,172],{"title":153,"path":155,"stem":159},"4.resources\u002Findex",{"title":161,"path":162,"stem":163},"Frequently asked questions","\u002Fresources\u002Ffaq","4.resources\u002F1.faq",{"title":165,"path":166,"stem":167},"Troubleshooting","\u002Fresources\u002Ftroubleshooting","4.resources\u002F2.troubleshooting",{"title":169,"path":170,"stem":171},"API changelog","\u002Fresources\u002Fchangelog","4.resources\u002F3.changelog",{"title":173,"path":174,"stem":175},"Migration guides","\u002Fresources\u002Fmigrations","4.resources\u002F4.migrations",{"id":177,"title":97,"apiOperation":178,"body":179,"description":350,"extension":351,"links":178,"meta":352,"navigation":353,"path":98,"related":178,"seo":354,"stem":99,"__hash__":355},"docs\u002F2.guides\u002F9.preventing-duplicates.md",null,{"type":180,"value":181,"toc":345},"minimark",[182,186,226,237,242,303,306,310,335,341],[183,184,185],"p",{},"Generate one idempotency key per logical submission:",[187,188,193],"pre",{"className":189,"code":190,"language":191,"meta":192,"style":192},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const key = crypto.randomUUID()\n","ts","",[194,195,196],"code",{"__ignoreMap":192},[197,198,201,205,209,213,216,219,223],"span",{"class":199,"line":200},"line",1,[197,202,204],{"class":203},"spNyl","const",[197,206,208],{"class":207},"sTEyZ"," key ",[197,210,212],{"class":211},"sMK4o","=",[197,214,215],{"class":207}," crypto",[197,217,218],{"class":211},".",[197,220,222],{"class":221},"s2Zo4","randomUUID",[197,224,225],{"class":207},"()\n",[183,227,228,229,232,233,236],{},"Send it in the ",[194,230,231],{},"Idempotency-Key"," header, or in ",[194,234,235],{},"_idempotency_key"," for an HTML form. The key is scoped to the form and retained for the form’s retention period.",[238,239,241],"h2",{"id":240},"replay-behaviour","Replay behaviour",[243,244,245,258],"table",{},[246,247,248],"thead",{},[249,250,251,255],"tr",{},[252,253,254],"th",{},"Situation",[252,256,257],{},"Result",[259,260,261,277,287,295],"tbody",{},[249,262,263,267],{},[264,265,266],"td",{},"Same key, equivalent payload",[264,268,269,272,273,276],{},[194,270,271],{},"200",", same ",[194,274,275],{},"submission_id",", no new delivery",[249,278,279,282],{},[264,280,281],{},"Same key, different payload",[264,283,284],{},[194,285,286],{},"409 idempotency_conflict",[249,288,289,292],{},[264,290,291],{},"New key, same payload",[264,293,294],{},"New submission",[249,296,297,300],{},[264,298,299],{},"Key after retention purge",[264,301,302],{},"May be reused as a new submission",[183,304,305],{},"Equivalent payload means the same fields and values after control fields are removed and object keys are canonicalised. Field order does not matter. Turnstile and honeypot values are excluded from the digest.",[238,307,309],{"id":308},"retry-rules","Retry rules",[311,312,313,322,325,328],"ul",{},[314,315,316,317,321],"li",{},"Reuse the key when retrying the ",[318,319,320],"strong",{},"unchanged"," payload.",[314,323,324],{},"Rotate the key after success.",[314,326,327],{},"Rotate the key when the user changes the data.",[314,329,330,331,334],{},"Do not retry a ",[194,332,333],{},"409","; it means the content changed.",[336,337,338],"tip",{},[183,339,340],{},"The key does not prevent a user from deliberately submitting the same enquiry twice with a new key. Postvia does not silently block legitimate repeat enquiries.",[342,343,344],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":192,"searchDepth":346,"depth":346,"links":347},2,[348,349],{"id":240,"depth":346,"text":241},{"id":308,"depth":346,"text":309},"Use idempotency keys for safe retries without duplicate notifications.","md",{},true,{"title":97,"description":350},"ZAOcMIkvrIAO-Fhz0NYTJF_4_y8pUanp-Hfhs1aaptQ",[357,359],{"title":93,"path":94,"stem":95,"description":358,"children":-1},"Distinguish durable acceptance from email delivery and reset the form safely.",{"title":106,"path":102,"stem":103,"description":360,"children":-1},"The public Postvia submission API, its base URL and response modes.",1795377933293]