Getting StartedFAQ
Getting Started
FAQ
Answers to common Northstar integration questions.
Is Northstar a real service?
No. Northstar is a fictional product used to demonstrate a complete documentation experience built with Knowybase.
Which API version should I use?
New integrations should use
/v1. A major version remains stable, while backward-compatible fields and endpoints may be added over time.Can I use one token in every environment?
You can, but you should not. Use separate scoped tokens for local development, CI, staging, and production so each credential can be rotated or revoked independently.
How should I store tokens?
Use the secret manager provided by your hosting platform. Never include tokens in frontend code, repository files, screenshots, or support messages.
Are webhook events delivered in order?
Usually, but ordering is not guaranteed. Use each event's timestamp and retrieve the current resource when ordering matters.
Why did I receive the same webhook twice?
Northstar uses at-least-once delivery. Store processed event identifiers or make your handler idempotent.
How do I request support?
Include the request identifier, approximate timestamp, endpoint, and response status. Do not send API tokens or full sensitive payloads.
Where should I start?
Follow the Quickstart, then review Authentication and Deployment before connecting a production application.