[{"data":1,"prerenderedAt":603},["ShallowReactive",2],{"navigation":3,"\u002Fguides\u002Fcloudflare-turnstile":176,"\u002Fguides\u002Fcloudflare-turnstile-surround":598},[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":85,"apiOperation":178,"body":179,"description":593,"extension":594,"links":178,"meta":595,"navigation":257,"path":86,"related":178,"seo":596,"stem":87,"__hash__":597},"docs\u002F2.guides\u002F6.cloudflare-turnstile.md",null,{"type":180,"value":181,"toc":587},"minimark",[182,195,200,353,356,455,459,481,485,567,571,577,583],[183,184,185,186,190,191,194],"p",{},"Turnstile is verified server-side by Postvia. The expected hostname is the customer website origin, not ",[187,188,189],"code",{},"api.postvia.dev",". A provider outage fails closed with a retryable ",[187,192,193],{},"503",".",[196,197,199],"h2",{"id":198},"widget","Widget",[201,202,207],"pre",{"className":203,"code":204,"language":205,"meta":206,"style":206},"language-html shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Cscript src=\"https:\u002F\u002Fchallenges.cloudflare.com\u002Fturnstile\u002Fv0\u002Fapi.js\" async defer>\u003C\u002Fscript>\n\n\u003Cdiv\n  class=\"cf-turnstile\"\n  data-sitekey=\"YOUR_PUBLIC_SITE_KEY\"\n  data-action=\"contact\"\n  data-callback=\"onTurnstileSuccess\"\n  data-expired-callback=\"onTurnstileExpired\"\n>\u003C\u002Fdiv>\n","html","",[187,208,209,252,259,267,283,298,313,328,343],{"__ignoreMap":206},[210,211,214,218,222,226,229,232,236,238,241,244,247,249],"span",{"class":212,"line":213},"line",1,[210,215,217],{"class":216},"sMK4o","\u003C",[210,219,221],{"class":220},"swJcz","script",[210,223,225],{"class":224},"spNyl"," src",[210,227,228],{"class":216},"=",[210,230,231],{"class":216},"\"",[210,233,235],{"class":234},"sfazB","https:\u002F\u002Fchallenges.cloudflare.com\u002Fturnstile\u002Fv0\u002Fapi.js",[210,237,231],{"class":216},[210,239,240],{"class":224}," async",[210,242,243],{"class":224}," defer",[210,245,246],{"class":216},">\u003C\u002F",[210,248,221],{"class":220},[210,250,251],{"class":216},">\n",[210,253,255],{"class":212,"line":254},2,[210,256,258],{"emptyLinePlaceholder":257},true,"\n",[210,260,262,264],{"class":212,"line":261},3,[210,263,217],{"class":216},[210,265,266],{"class":220},"div\n",[210,268,270,273,275,277,280],{"class":212,"line":269},4,[210,271,272],{"class":224},"  class",[210,274,228],{"class":216},[210,276,231],{"class":216},[210,278,279],{"class":234},"cf-turnstile",[210,281,282],{"class":216},"\"\n",[210,284,286,289,291,293,296],{"class":212,"line":285},5,[210,287,288],{"class":224},"  data-sitekey",[210,290,228],{"class":216},[210,292,231],{"class":216},[210,294,295],{"class":234},"YOUR_PUBLIC_SITE_KEY",[210,297,282],{"class":216},[210,299,301,304,306,308,311],{"class":212,"line":300},6,[210,302,303],{"class":224},"  data-action",[210,305,228],{"class":216},[210,307,231],{"class":216},[210,309,310],{"class":234},"contact",[210,312,282],{"class":216},[210,314,316,319,321,323,326],{"class":212,"line":315},7,[210,317,318],{"class":224},"  data-callback",[210,320,228],{"class":216},[210,322,231],{"class":216},[210,324,325],{"class":234},"onTurnstileSuccess",[210,327,282],{"class":216},[210,329,331,334,336,338,341],{"class":212,"line":330},8,[210,332,333],{"class":224},"  data-expired-callback",[210,335,228],{"class":216},[210,337,231],{"class":216},[210,339,340],{"class":234},"onTurnstileExpired",[210,342,282],{"class":216},[210,344,346,348,351],{"class":212,"line":345},9,[210,347,246],{"class":216},[210,349,350],{"class":220},"div",[210,352,251],{"class":216},[183,354,355],{},"Send the token in the reserved field:",[201,357,361],{"className":358,"code":359,"language":360,"meta":206,"style":206},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"name\": \"John Smith\",\n  \"email\": \"john@example.com\",\n  \"message\": \"Hello\",\n  \"cf-turnstile-response\": \"TURNSTILE_TOKEN\"\n}\n","json",[187,362,363,368,392,412,432,450],{"__ignoreMap":206},[210,364,365],{"class":212,"line":213},[210,366,367],{"class":216},"{\n",[210,369,370,373,376,378,381,384,387,389],{"class":212,"line":254},[210,371,372],{"class":216},"  \"",[210,374,375],{"class":224},"name",[210,377,231],{"class":216},[210,379,380],{"class":216},":",[210,382,383],{"class":216}," \"",[210,385,386],{"class":234},"John Smith",[210,388,231],{"class":216},[210,390,391],{"class":216},",\n",[210,393,394,396,399,401,403,405,408,410],{"class":212,"line":261},[210,395,372],{"class":216},[210,397,398],{"class":224},"email",[210,400,231],{"class":216},[210,402,380],{"class":216},[210,404,383],{"class":216},[210,406,407],{"class":234},"john@example.com",[210,409,231],{"class":216},[210,411,391],{"class":216},[210,413,414,416,419,421,423,425,428,430],{"class":212,"line":269},[210,415,372],{"class":216},[210,417,418],{"class":224},"message",[210,420,231],{"class":216},[210,422,380],{"class":216},[210,424,383],{"class":216},[210,426,427],{"class":234},"Hello",[210,429,231],{"class":216},[210,431,391],{"class":216},[210,433,434,436,439,441,443,445,448],{"class":212,"line":285},[210,435,372],{"class":216},[210,437,438],{"class":224},"cf-turnstile-response",[210,440,231],{"class":216},[210,442,380],{"class":216},[210,444,383],{"class":216},[210,446,447],{"class":234},"TURNSTILE_TOKEN",[210,449,282],{"class":216},[210,451,452],{"class":212,"line":300},[210,453,454],{"class":216},"}\n",[196,456,458],{"id":457},"rules","Rules",[460,461,462,466,469,472,475,478],"ul",{},[463,464,465],"li",{},"The token is single use.",[463,467,468],{},"Do not retry an invalid or expired token automatically.",[463,470,471],{},"Reset the widget after success and after a used token.",[463,473,474],{},"Never put the Turnstile secret in frontend code.",[463,476,477],{},"Keep the widget action aligned with the action configured in Postvia.",[463,479,480],{},"Allow the Cloudflare challenge domain in your CSP if you have a strict policy.",[196,482,484],{"id":483},"behaviour","Behaviour",[486,487,488,504],"table",{},[489,490,491],"thead",{},[492,493,494,498,501],"tr",{},[495,496,497],"th",{},"Result",[495,499,500],{},"HTTP",[495,502,503],{},"Error code",[505,506,507,525,540,553],"tbody",{},[492,508,509,513,522],{},[510,511,512],"td",{},"Valid token",[510,514,515,518,519],{},[187,516,517],{},"201"," \u002F ",[187,520,521],{},"200",[510,523,524],{},"—",[492,526,527,530,535],{},[510,528,529],{},"Missing or invalid token",[510,531,532],{},[187,533,534],{},"403",[510,536,537],{},[187,538,539],{},"verification_failed",[492,541,542,545,549],{},[510,543,544],{},"Wrong hostname or action",[510,546,547],{},[187,548,534],{},[510,550,551],{},[187,552,539],{},[492,554,555,558,562],{},[510,556,557],{},"Provider outage",[510,559,560],{},[187,561,193],{},[510,563,564],{},[187,565,566],{},"temporarily_unavailable",[196,568,570],{"id":569},"replays","Replays",[183,572,573,574,576],{},"An identical idempotent replay returns ",[187,575,521],{}," before Turnstile verification, because it creates nothing. A new submission or changed payload needs a fresh token.",[183,578,579,580,194],{},"See ",[581,582,112],"a",{"href":113},[584,585,586],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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 .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":206,"searchDepth":254,"depth":254,"links":588},[589,590,591,592],{"id":198,"depth":254,"text":199},{"id":457,"depth":254,"text":458},{"id":483,"depth":254,"text":484},{"id":569,"depth":254,"text":570},"Render the widget, send the token and handle verification failures correctly.","md",{},{"title":85,"description":593},"esBcBpEccK1OXoKbPip-GZxieSfMzGuTpY4ZR9KpwHo",[599,601],{"title":81,"path":82,"stem":83,"description":600,"children":-1},"Post a native HTML form and use the configured success redirect.",{"title":89,"path":90,"stem":91,"description":602,"children":-1},"Map 422 field errors to accessible form messages without losing the user’s input.",1795377933208]