Skip to content

docs: require a user agent for proof verification#143

Draft
realmehmetali wants to merge 1 commit into
worldcoin:mainfrom
realmehmetali:agent/document-verify-user-agent
Draft

docs: require a user agent for proof verification#143
realmehmetali wants to merge 1 commit into
worldcoin:mainfrom
realmehmetali:agent/document-verify-user-agent

Conversation

@realmehmetali

Copy link
Copy Markdown

Changes

  • declare User-Agent as a required header on the v4 verify OpenAPI operation
  • add the header to the primary IDKit and standalone migration backend examples
  • teach the LLM integration prompt and World ID skill how to avoid and diagnose bot-protection 403 responses

Why

Backend requests without a user agent can be rejected by bot protection, but neither the generated API reference nor the integration examples made that requirement visible.

Impact

Human readers, generated clients, and coding assistants now receive consistent verification-request guidance.

Closes #82.

Checks

  • jq empty openapi/developer-portal.json
  • corepack pnpm spellcheck (131 files, 0 issues)
  • mint broken-links under Node 24 LTS (no broken links)
  • staged diff leakage scan

Disclosure

This contribution was prepared with AI assistance and reviewed against the public repository and public issue #82 only. No private code, production data, or internal implementation details were used.

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.

Suggestion: make it clear that User-Agent must be specified in request

1 participant