API Documentation
Where to find the full API reference and how authentication works.
Full API docs
The complete API documentation is available at API Documentation. Access to /docs requires you to be logged in; the page is protected so only registered users can view it. There you will find the base URL, authentication (JWT and API key), and all supported endpoints.
Public vs authenticated
Public endpoints (e.g. GET /api/postboxes, /api/feed, /api/leaderboard, /api/stats, /api/users/:id) do not require authentication. For writing (submitting postboxes, comments, corrections, creating API keys) you must send a JWT (from the website session) or an API key in the request.
Authentication
Send JWT as Authorization: Bearer <token>. Send API key as X-API-Key: <key> (preferred; avoid putting the key in query params). You can create and manage API keys under Profile → API keys. See Getting API Keys for more.