Skip to content

Fix auth header in API docs (access-token, not Authorization: Bearer)#10

Open
pimfeltkamp wants to merge 1 commit intomainfrom
fix-auth-header-docs
Open

Fix auth header in API docs (access-token, not Authorization: Bearer)#10
pimfeltkamp wants to merge 1 commit intomainfrom
fix-auth-header-docs

Conversation

@pimfeltkamp
Copy link
Copy Markdown

Tracking: #9. Companion to the transport-fix PRs landing in all 8 SDK repos this same hour (Node #9, Python #4, Go #4, Ruby #3, Rust #7, PHP #6, Dart #4, Swift #2).

The local docs in this repo described the auth header as Authorization: Bearer <token>, which is what every SDK in the org has been sending — and what the AWS API Gateway in front of the production API rejects with 405 Missing Authentication Token. The actual header is access-token: <token>, as documented at https://www.cryptohopper.com/api-documentation/how-the-api-works and used by the legacy iOS/Android SDKs and the code-samples repo.

Files changed

  • docs/api/authentication.mdAuthorization: Bearer block replaced with access-token; added a note explaining the v1-vs-V2 split (V2 uses Bearer; v1 — what these SDKs target — does not).
  • docs/api/getting-started.md — same fix in two places (the inline header example and the GET-hopper example).

The remaining Authorization mentions in authentication.md are about the OAuth2 "Authorization Code Flow" grant type and the consent-page URL — those are correct usage.

What's NOT in this PR (separate sweeps already done or pending)

Ready to merge as soon as you can take a look.

…ation: Bearer)

The Public API v1 uses an 'access-token: <token>' header, not the
OAuth2-conventional 'Authorization: Bearer <token>' that the docs
described. The AWS API Gateway in front of the production API
rejects Bearer-style Authorization headers (it routes them to a
SigV4 parser and returns 405 Missing Authentication Token).

This was the root cause behind cryptohopper-resources#9 and the
matching transport fixes shipped today across all 8 SDKs.

Source-of-truth references:
- https://www.cryptohopper.com/api-documentation/how-the-api-works
- cryptohopper/cryptohopper-ios-sdk HopperAPIRequest.swift:248
- cryptohopper/cryptohopper-android-sdk HopperAPIRequest.kt:331
- cryptohopper/code-samples curl/README.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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