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