Глоссарий FazerCards
REST API
HTTP API по правилам REST (ресурсы по стабильным URL, JSON, стандартные методы) — формат, в котором FazerCards публикует /api/v2.
REST расшифровывается как representational state transfer over HTTP. Ресурсы (catalog, order, balance) живут по стабильным URL, GET читает, POST создаёт заказ. Публичная поверхность FazerCards — REST: JSON in/out, X-Api-Key для авторизации, стандартные коды 200/201/4xx/5xx. REST предпочтителен над GraphQL для этой доменной области: операции простые, клиент — обычно бэкенд, а не UI с типизированной схемой.
Главные факты
- Базовый URL: https://api.fzr.cards/api/v2
- OpenAPI: /public/docs
- Авторизация: заголовок X-Api-Key
- Ошибки в едином JSON-формате code + message