Skip to content

docs(server-side-verification): document /siteverify error responses#46

Merged
forgetso merged 1 commit into
mainfrom
docs/siteverify-error-reference
Jun 15, 2026
Merged

docs(server-side-verification): document /siteverify error responses#46
forgetso merged 1 commit into
mainfrom
docs/siteverify-error-reference

Conversation

@forgetso

Copy link
Copy Markdown
Member

Summary

  • Append an Error Responses section to basics/server-side-verification.mdx covering the response envelope, HTTP 200 soft failures (decode failure + provider timeout fail-open), 4xx integration errors, 5xx upstream errors, forwarded provider error keys, and recommended client handling guidance.
  • Derived from a code walk of verifyPayload.ts and util/error.ts in captcha-private; no behavioural claims beyond what the handler currently does.

Test plan

  • npm run dev and visit /en/basics/server-side-verification/ — confirm the new section renders, tables format correctly, and the #forwarded-provider-errors in-page anchor resolves.
  • Build the docs (npm run build) and check for MDX/lint warnings on the modified page.
  • Spot-check that the i18nReady: true frontmatter is unchanged so translators are flagged via Lunaria for the new English content.

🤖 Generated with Claude Code

Add an Error Responses section covering the response envelope, HTTP 200
soft failures (including fail-open on provider timeout), 4xx integration
errors, 5xx upstream errors, forwarded provider error keys, and
recommended client handling guidance.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@netlify

netlify Bot commented Jun 15, 2026

Copy link
Copy Markdown

Deploy Preview for peaceful-pothos-9e62ce ready!

Name Link
🔨 Latest commit 2f0a8f3
🔍 Latest deploy log https://app.netlify.com/projects/peaceful-pothos-9e62ce/deploys/6a3032915f43d90008931f2a
😎 Deploy Preview https://deploy-preview-46--peaceful-pothos-9e62ce.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@forgetso forgetso merged commit 125afdb into main Jun 15, 2026
4 checks passed
@forgetso forgetso deleted the docs/siteverify-error-reference branch June 15, 2026 17:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant