Introduction
Base URL
Section intitulée « Base URL »https://tickr.coderise.cloud/api/v1All public API endpoints are mounted under /api/v1. The version segment is
part of the path; we won’t ship a breaking change without bumping it.
Internal vs public surface
Section intitulée « Internal vs public surface »Tickr exposes two HTTP surfaces:
| Surface | Path prefix | Auth | Audience |
|---|---|---|---|
| Internal API | /api/... | JWT (Bearer) | Tickr web frontend only. |
| Public API | /api/v1/... | API key (Authorization: Bearer tkr_...) | Third-party integrations. |
The two surfaces share data but differ in shape. The public API is curated: fewer endpoints, simpler payloads, stable versioning, no UI-only fields. Use the internal API only if you are building a Tickr-internal feature — its contract may change at any release.
Versioning policy
Section intitulée « Versioning policy »v1is the only version today.- Breaking changes (renamed fields, removed endpoints, type changes) will be
released as
v2and announced ahead of time. - Additive changes (new endpoints, new optional fields) ship in
v1without notice.