Добавление сайта
Добавляет сайт в список сайтов пользователя.
Формат запроса
POST https://api.webmaster.yandex.net/v4/user/{user-id}/hosts
user-id | Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user. |
user-id | Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user. |
В теле запроса укажите имя нового сайта, а также требуемый тип данных в заголовке Content-type
(application/json
или application/xml
).
Пример
Параметр | Описание |
---|---|
host_url | URI добавляемого сайта. |
Параметр | Описание |
---|---|
host_url | URI добавляемого сайта. |
Формат ответа
Пример
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
host_id | Да | host id (string) | ID добавленного сайта. |
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
host_id | Да | host id (string) | ID добавленного сайта. |
Коды ответа
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
Код | Причина | Описание |
---|---|---|
201 | CREATED | Сайт добавлен в список пользователя. |
403 | HOSTS_LIMIT_EXCEEDED | Превышен лимит количества сайтов в списке сайтов пользователя (текущий лимит — 1703). |
ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже | ||
409 | HOST_ALREADY_ADDED | Сайт с таким именем уже добавлен в список сайтов пользователя. |
Код | Причина | Описание |
---|---|---|
201 | CREATED | Сайт добавлен в список пользователя. |
403 | HOSTS_LIMIT_EXCEEDED | Превышен лимит количества сайтов в списке сайтов пользователя (текущий лимит — 1703). |
ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже | ||
409 | HOST_ALREADY_ADDED | Сайт с таким именем уже добавлен в список сайтов пользователя. |