Добавление файла Sitemap
Внимание. Вы открыли документацию API версии 3.2. Яндекс Вебмастер перестал поддерживать версию 3.2 и ниже со второго полугодия 2020 г. Рекомендуем использовать API версии 4.1.
Добавляет файл Sitemap в Яндекс Вебмастер.
Формат запроса
В теле запроса передайте URL файла Sitemap, а также укажите требуемый тип данных в заголовке Content-type
(application/json
или application/xml
):
POST https://api.webmaster.yandex.net/v3.2/user/{user-id}/hosts/{host-id}/user-added-sitemaps/
Content-type: application/xml
Path-параметры
Имя | Обязательный | Тип | Значение по умолчанию | Описание |
---|---|---|---|---|
user-id | Да | int64 | ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /user. | |
host-id | Да | host id | ID сайта. Чтобы получить его, используйте метод GET /user/{user-id}/hosts. |
Имя | Обязательный | Тип | Значение по умолчанию | Описание |
---|---|---|---|---|
user-id | Да | int64 | ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /user. | |
host-id | Да | host id | ID сайта. Чтобы получить его, используйте метод GET /user/{user-id}/hosts. |
Пример
Параметр | Описание |
---|---|
url | URL добавляемого файла Sitemap. |
Параметр | Описание |
---|---|
url | URL добавляемого файла Sitemap. |
Формат ответа
Примеры
Имя | Обязательный | Тип | Описание |
---|---|---|---|
sitemap_id | Да | string | ID добавленного файла Sitemap. |
Имя | Обязательный | Тип | Описание |
---|---|---|---|
sitemap_id | Да | string | ID добавленного файла Sitemap. |
Коды ответа
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
Код | Причина | Описание |
---|---|---|
201 | CREATED | |
403 | ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
409 | SITEMAP_ALREADY_ADDED | Файл Sitemap уже добавлен. |
Код | Причина | Описание |
---|---|---|
201 | CREATED | |
403 | ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
409 | SITEMAP_ALREADY_ADDED | Файл Sitemap уже добавлен. |