С чего начать работу

Основные правила обращения к сервису.

Все адреса работают только по HTTPS. Запрос без параметров возвращает весь набор целиком.

Так как данные меняются редко, разумно кэшировать ответ и обращаться к сети пореже.

Кто может обращаться

Кто угодно и откуда угодно. Ограничений по аккаунтам нет, есть только мягкий предел частоты запросов — см. раздел о лимитах.

Данные не персонализируются: ответ зависит только от адреса набора.

Мы не убираем и не переименовываем поля в пределах версии. Новые поля могут добавляться, поэтому разбирайте JSON терпимо к незнакомым ключам.

Привязывайтесь к конкретной версии в адресе — так обновление станет осознанным шагом.

Получив 404, проверьте адрес набора: он должен в точности совпадать с тем, что указан в справочнике.

Получив 429, сделайте паузу и повторите запрос. Для постоянной работы держите локальную копию данных.

Все ответы — в формате JSON с кодировкой UTF-8 и типом application/json. Числа отдаются как числа, строки — как строки.

Ответ набора — это всегда массив объектов; порядок записей устойчив между запросами.

Код	Значение
200	Запрос выполнен, тело ответа — JSON.
404	Такого набора данных или записи нет.
429	Слишком много запросов, повторите чуть позже.