Как работать с версиями API

  1. Система нумерации
  2. Поддерживаемые версии
  3. Использование версии 4

Система нумерации

Номер версии состоит из двух чисел, например 4.1. При каждом обновлении номер версии увеличивается:
  • первое число — при значительных изменениях в архитектуре API;
  • второе — при поддержке обратной совместимости с предыдущими версиями.

Поддерживаемые версии

  • 3.2 — архивная версия;
  • 4.0 — архивная версия;
  • 4.1 — актуальная версия.

Архивные версии продолжают поддерживаться, но не дополняются новой функциональностью.

Справочник для версии 3.2 доступен по отдельному адресу. Справочник версии 4 обновляется до актуальной версии в текущей документации. Изменения между версиями представлены в руководстве по переходу на новую версию. Для каждой версии поддерживается отдельное руководство:

Использование версии 4

В справочнике ресурсов вы можете найти формат запросов. При использовании версии 4 в запросе можно указывать v4, если в формате не указано иное — чтобы по умолчанию использовать актуальную версию API.

Чтобы использовать архивную версию, укажите в запросе версию явно, например v4.0.