Conventions
- Content types:
application/json; character set UTF-8 - Date/time: ISO 8601 with timezone offset or Z (e.g.,
2026-04-21T13:45:00Z) - Ids: UUID v4 unless otherwise specified
- Idempotency2:
Idempotency-Keyheader for POST/PUT with retry safety - Localization:
Accept-Languageheader (ka,en)
Common Headers
Authorization: Bearer <token>Content-Type: application/jsonAccept: application/jsonIdempotency-Key: <uuid-v4>(optional but recommended)Accept-Language: ka|en(optional)