Введение

Внимание. Вы открыли документацию API версии 4.1. Документация версии 3.2.

Яндекс Вебмастер перестал поддерживать версию 3.2 и ниже со второго полугодия 2020 г.

Программный интерфейс к службе Яндекс Вебмастер (далее API Яндекс Вебмастера) дает возможность разработчикам создавать приложения для работы с пользовательскими данными, хранящимися на сервисе Яндекс Вебмастер.

Например, с помощью API Яндекс Вебмастера вы можете дать возможность вашим пользователям получать и редактировать списки своих сайтов, добавлять новые сайты, узнавать статус подтверждения сайта, статистику его индексирования и др.

Примерами возможных приложений являются:

создание надстройки Яндекс Вебмастера к панели управления сайтом хостинговой компании;
создание приложений для управления сайтами.

Как работает API

API Яндекс Вебмастера реализовано на REST-принципах (Representational State Transfer) с использованием HTTP и JSON/XML для обмена данными.

Клиентское приложение обменивается JSON/XML-сообщениями с сервером API Яндекс Вебмастера посредством HTTP-запросов в соответствии с REST-принципами: ресурсы сайтов и списков сайтов получаются методом HTTP GET, создаются методом HTTP POST и удаляются методом HTTP DELETE, см. Обзор ресурсов API.

API Яндекс Вебмастера доступен для идентифицированных пользователей по адресу:

https://api.webmaster.yandex.net/

Запросы к API могут содержать параметры двух типов:

Path-параметры — параметры, являющиеся частью URL ресурса.
Query-параметры — параметры, добавленные к URL ресурса после знака ?.

Внимание. При обмене данными между клиентским приложением и службой Яндекс Вебмастер всегда используйте кодировку UTF-8.

Так как большинство действий в API Яндекс Вебмастера выполняется от имени конкретного пользователя, клиентское приложение должно быть авторизовано.

Кроме этого, при обращении к ресурсам API необходимо указывать ID пользователя. Его можно получить в начале работы с помощью вызова ресурса user.

Формат обмена данными

Запросы к API выполняются по протоколу HTTPS. По умолчанию сервис возвращает данные в формате JSON. Чтобы получить XML-ответ, передайте в запросе HTTP-заголовок Accept: application/xml.

Условия использования API

Для начала работы с API Яндекс Вебмастера необходимо зарегистрировать приложение и получить client_id.

Использование API для написания пользовательских клиентских приложений подразумевает принятие Условий использования сервиса «API Яндекс Вебмастер». Действия клиентского приложения не должны противоречить правилам, установленным в этом документе.

Для выполнения действий с сайтами и списками сайтов, требующих обязательной авторизации, конечный пользователь клиентского приложения должен согласиться с пользовательским соглашением службы Яндекс Вебмастер. Клиентское приложение должно явно информировать его о такой необходимости.