[{"data":1,"prerenderedAt":502},["ShallowReactive",2],{"navigation":3,"\u002Fapi\u002Fidempotency":176,"\u002Fapi\u002Fidempotency-surround":497},[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":108,"apiOperation":178,"body":179,"description":491,"extension":492,"links":178,"meta":493,"navigation":494,"path":109,"related":178,"seo":495,"stem":110,"__hash__":496},"docs\u002F3.api\u002F10.idempotency.md",null,{"type":180,"value":181,"toc":484},"minimark",[182,195,200,219,223,226,242,324,327,331,337,441,444,448,451,462,465,469,472,480],[183,184,185,186,190,191,194],"p",{},"Use the optional ",[187,188,189],"code",{},"Idempotency-Key"," header, or ",[187,192,193],{},"_idempotency_key"," for HTML forms, to make retries safe.",[196,197,199],"h2",{"id":198},"rules","Rules",[201,202,203,207,210,213,216],"ul",{},[204,205,206],"li",{},"Maximum 128 characters.",[204,208,209],{},"Scoped to the form, not the endpoint.",[204,211,212],{},"If both the header and field are supplied, their values must match.",[204,214,215],{},"Generate one key per logical submission and reuse it while the payload is unchanged.",[204,217,218],{},"Rotate the key after success or when the payload changes.",[196,220,222],{"id":221},"replay","Replay",[183,224,225],{},"An identical request with the same key and equivalent payload returns:",[227,228,233],"pre",{"className":229,"code":230,"language":231,"meta":232,"style":232},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","HTTP\u002F1.1 200 OK\n","http","",[187,234,235],{"__ignoreMap":232},[236,237,240],"span",{"class":238,"line":239},"line",1,[236,241,230],{},[227,243,247],{"className":244,"code":245,"language":246,"meta":232,"style":232},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"success\": true,\n  \"submission_id\": \"8f2c1e7a4b6d8c0e5f3a2b1c9d8e7f60\",\n  \"message\": \"Your enquiry has been received.\"\n}\n","json",[187,248,249,255,274,298,318],{"__ignoreMap":232},[236,250,251],{"class":238,"line":239},[236,252,254],{"class":253},"sMK4o","{\n",[236,256,258,261,265,268,271],{"class":238,"line":257},2,[236,259,260],{"class":253},"  \"",[236,262,264],{"class":263},"spNyl","success",[236,266,267],{"class":253},"\"",[236,269,270],{"class":253},":",[236,272,273],{"class":253}," true,\n",[236,275,277,279,282,284,286,289,293,295],{"class":238,"line":276},3,[236,278,260],{"class":253},[236,280,281],{"class":263},"submission_id",[236,283,267],{"class":253},[236,285,270],{"class":253},[236,287,288],{"class":253}," \"",[236,290,292],{"class":291},"sfazB","8f2c1e7a4b6d8c0e5f3a2b1c9d8e7f60",[236,294,267],{"class":253},[236,296,297],{"class":253},",\n",[236,299,301,303,306,308,310,312,315],{"class":238,"line":300},4,[236,302,260],{"class":253},[236,304,305],{"class":263},"message",[236,307,267],{"class":253},[236,309,270],{"class":253},[236,311,288],{"class":253},[236,313,314],{"class":291},"Your enquiry has been received.",[236,316,317],{"class":253},"\"\n",[236,319,321],{"class":238,"line":320},5,[236,322,323],{"class":253},"}\n",[183,325,326],{},"No new submission, delivery or notification is created. Replays are returned after origin and rate-limit checks but before Turnstile verification, so a lost response can be retried without consuming another single-use token.",[196,328,330],{"id":329},"conflicting-payloads","Conflicting payloads",[183,332,333,334,270],{},"Reusing a key with different content returns ",[187,335,336],{},"409 idempotency_conflict",[227,338,340],{"className":244,"code":339,"language":246,"meta":232,"style":232},"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"idempotency_conflict\",\n    \"message\": \"This idempotency key was already used with different content.\"\n  },\n  \"request_id\": \"01JY8Z3K4M5N6P7Q8R9S0T1V2W\"\n}\n",[187,341,342,346,359,373,394,411,417,436],{"__ignoreMap":232},[236,343,344],{"class":238,"line":239},[236,345,254],{"class":253},[236,347,348,350,352,354,356],{"class":238,"line":257},[236,349,260],{"class":253},[236,351,264],{"class":263},[236,353,267],{"class":253},[236,355,270],{"class":253},[236,357,358],{"class":253}," false,\n",[236,360,361,363,366,368,370],{"class":238,"line":276},[236,362,260],{"class":253},[236,364,365],{"class":263},"error",[236,367,267],{"class":253},[236,369,270],{"class":253},[236,371,372],{"class":253}," {\n",[236,374,375,378,381,383,385,387,390,392],{"class":238,"line":300},[236,376,377],{"class":253},"    \"",[236,379,187],{"class":380},"sBMFI",[236,382,267],{"class":253},[236,384,270],{"class":253},[236,386,288],{"class":253},[236,388,389],{"class":291},"idempotency_conflict",[236,391,267],{"class":253},[236,393,297],{"class":253},[236,395,396,398,400,402,404,406,409],{"class":238,"line":320},[236,397,377],{"class":253},[236,399,305],{"class":380},[236,401,267],{"class":253},[236,403,270],{"class":253},[236,405,288],{"class":253},[236,407,408],{"class":291},"This idempotency key was already used with different content.",[236,410,317],{"class":253},[236,412,414],{"class":238,"line":413},6,[236,415,416],{"class":253},"  },\n",[236,418,420,422,425,427,429,431,434],{"class":238,"line":419},7,[236,421,260],{"class":253},[236,423,424],{"class":263},"request_id",[236,426,267],{"class":253},[236,428,270],{"class":253},[236,430,288],{"class":253},[236,432,433],{"class":291},"01JY8Z3K4M5N6P7Q8R9S0T1V2W",[236,435,317],{"class":253},[236,437,439],{"class":238,"line":438},8,[236,440,323],{"class":253},[183,442,443],{},"The original submission is not changed and no notification is sent.",[196,445,447],{"id":446},"equivalence","Equivalence",[183,449,450],{},"Payloads are compared after:",[201,452,453,456,459],{},[204,454,455],{},"removing reserved control fields;",[204,457,458],{},"canonicalising object key order;",[204,460,461],{},"recursively preserving list order.",[183,463,464],{},"Turnstile and honeypot values are excluded from the digest.",[196,466,468],{"id":467},"retention","Retention",[183,470,471],{},"The key is stored on the submission and retained for the form’s retention period (default 90 days, maximum 365 days). The scheduled retention purge removes it. After purge, reusing an old key may create a new submission, so always generate unique keys.",[183,473,474,475,479],{},"See ",[476,477,478],"a",{"href":98},"Preventing duplicate submissions",".",[481,482,483],"style",{},"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);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":232,"searchDepth":257,"depth":257,"links":485},[486,487,488,489,490],{"id":198,"depth":257,"text":199},{"id":221,"depth":257,"text":222},{"id":329,"depth":257,"text":330},{"id":446,"depth":257,"text":447},{"id":467,"depth":257,"text":468},"Safe retries, replay semantics, conflict behaviour and key retention.","md",{},true,{"title":108,"description":491},"MVfEKNMx7kzje-OJPUrNb2QsOiORMnoWjs1Glx3GLm0",[498,500],{"title":106,"path":102,"stem":103,"description":499,"children":-1},"The public Postvia submission API, its base URL and response modes.",{"title":112,"path":113,"stem":114,"description":501,"children":-1},"Origin checks, Turnstile, honeypot, rate limits and public API data boundaries.",1795377933351]