Вопросы и ответы
Собрали здесь то, что чаще всего хотят узнать.
Можно ли использовать API в коммерческом проекте?
Да. Данные открыты, ограничений по виду использования нет. Разумно держать копию у себя и соблюдать мягкий предел частоты запросов.
Нужно ли передавать заголовки?
Нет. Специальные заголовки не требуются. Можно указать Accept: application/json, но и без него ответ придёт в JSON.
Сколько записей в наборах?
Зависит от набора. Точное число записей и размер файла указаны в справочнике рядом с каждым адресом.
Поддерживаются ли параметры и фильтры?
Сейчас набор отдаётся целиком, без параметров и фильтров. Отбор нужных записей проще сделать на стороне клиента после разбора JSON.
Что вернётся на запрос без указания набора?
Обращаться нужно к конкретному адресу набора. Запрос по несуществующему адресу вернёт 404 — сверьтесь со справочником.
Можно ли кэшировать ответы?
Да, и это рекомендуется. Данные почти не меняются, поэтому их удобно сохранить у себя и обновлять по расписанию, а не при каждом обращении.
Можно ли скачать набор целиком?
Да. Каждый набор — это один файл по постоянному адресу. Откройте его и сохраните; для постоянной работы это удобнее частых запросов.
Под какой лицензией можно использовать данные?
Данные опираются на открытые стандарты и свободные базы, их можно использовать свободно. При необходимости указывайте источник стандарта.