Interactive API Documentation

General Principles

This section describes the general rules and structures used throughout the API. Understanding these principles is essential for successful integration.

Request Headers

Every request to the API must contain the following headers:

Authorization: Bearer <service_token>
X-User-ID: <external_user_id>

Response Structure

All server responses follow a unified JSON structure.

{
  "data": <...>,
  "message": "...",
  "next_refresh": 1753843200
}