Making requests

Use the versioned base path, send JSON, keep an idempotency key for retryable writes and retain the request id from every response.

Base URL and versions

Public examples use https://api.gobito.one/v1. The deployed Spring routes currently carry /api/v1; the edge gateway owns the external /v1 mapping.

http
GET /v1/platform/usage HTTP/1.1
Host: api.gobito.one
Authorization: Bearer $GOBITO_KEY
Accept: application/json

Idempotent writes

For operations that may be retried, generate one stable key per user intent and send it again with the replay. Never generate a new key inside the retry loop.

http
Idempotency-Key: 3e7403c5-42f3-45fd-a688-ccde902391ba

Pagination and filtering

Collection endpoints use opaque cursors. Treat the cursor as a token, not a value to parse or construct.