Как работать с версиями API
Система нумерации
Номер версии состоит из двух чисел, например 4.1. При каждом обновлении номер версии увеличивается:
-
первое число — при значительных изменениях в архитектуре API;
-
второе — при поддержке обратной совместимости с предыдущими версиями.
Поддерживаемые версии
-
3.2 — архивная версия;
-
4.0 — архивная версия;
-
4.1 — актуальная версия.
Архивные версии продолжают поддерживаться, но не дополняются новой функциональностью.
Справочник для версии 3.2 доступен по отдельному адресу. Справочник версии 4 обновляется до актуальной версии в текущей документации. Изменения между версиями представлены в руководстве по переходу на новую версию. Для каждой версии поддерживается отдельное руководство:
Использование версии 4
В справочнике ресурсов вы можете найти формат запросов. При использовании версии 4 в запросе можно указывать v4
, если в формате не указано иное — чтобы по умолчанию использовать актуальную версию API.
Чтобы использовать архивную версию, укажите в запросе версию явно, например v4.0
.