Skip to content

docs: use real fr_sk_ API key format across README + SDK docstrings - #58

Merged
sayonfortify merged 1 commit into
mainfrom
fix/readme-api-key-format
Jun 22, 2026
Merged

docs: use real fr_sk_ API key format across README + SDK docstrings#58
sayonfortify merged 1 commit into
mainfrom
fix/readme-api-key-format

Conversation

@sayonfortify

Copy link
Copy Markdown
Contributor

What & why

README examples used api_key="fr-xxx", which is not the API key format the platform issues or accepts. Real keys are fr_sk_<token> — minted by GenerateAPIKey() (fr-common/domain/apikey.go, APIKeyPrefix = "fr_sk_") and validated by the ingestion auth prefix check (fr-backend/internal/ingestion/auth.go). The fr-xxx placeholder taught a value the backend would reject, and the wrong shape (hyphen vs fr_sk_).

Changes

  • Replace all 6 api_key="fr-xxx" occurrences with api_key="fr_sk_...".
  • Mirror the in-app Getting Started quickstart so the two canonical quickstarts are identical: add an app_name comment and resource_attributes={"environment": "dev"} (the SDK aliases environmentdeployment.environment, used by the backend as the env dimension).

Notes

  • Docs-only; no SDK code changes (the SDK was already correct — the docs were stale).
  • Companion fix in fr-frontend (Getting Started page) corrects the matching snippet there, including a real bug (config_idconfig_profile_id).

README examples used api_key="fr-xxx", which is not the format the
platform mints or accepts. Real keys are fr_sk_<token> (generated by
GenerateAPIKey and validated by the ingestion auth prefix check), so the
documented placeholder taught a value the backend would reject.

- Replace all 6 api_key="fr-xxx" occurrences with "fr_sk_..."
- Mirror the app Getting Started quickstart: add an app_name comment and
  resource_attributes={"environment": "dev"} so the two canonical
  quickstarts are identical
@sayonfortify
sayonfortify merged commit d0ea70c into main Jun 22, 2026
6 checks passed
@sayonfortify
sayonfortify deleted the fix/readme-api-key-format branch June 22, 2026 13:50
@sayonfortify sayonfortify changed the title docs(readme): use real fr_sk_ API key format in all examples docs: use real fr_sk_ API key format across README + SDK docstrings Jun 22, 2026
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