Формат

Базовый адрес #

У каждой школы свой: это коробка, общего адреса нет.

Тело запроса и ответа #

JSON в UTF-8. Никакого base64 внутри form-urlencoded.

Именование #

Множественное число, snake_case, вложенность не глубже двух уровней.

Идентификаторы #

Префиксные и типизированные: ord_… это заказ, pay_… — платёж. Ошибка «передал не тот ID» видна сразу.

Даты #

ISO 8601 с таймзоной, всегда.

Деньги #

Целое число в минорных единицах и код валюты — всегда парой.

Конверт ответа #

Объект отдаётся напрямую, список — с курсором.