Получение ссылки для загрузки RSS-канала
Возвращает ссылку для загрузки RSS-канала. Ссылка действительна в течение 10 минут после ее получения.
Формат запроса
GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/host-id/turbo/uploadAddress
? [mode=<string>]
|
Идентификатор пользователя. Значение можно получить с помощью операции GET /v4/user. |
|
Идентификатор сайта. Имеет формат
Например: Также идентификатор сайта можно получить с помощью операции GET /user/{user-id}/hosts. |
|
Режим загрузки RSS-канала. Возможные значения:
Значение по умолчанию: |
Формат ответа
Сервис возвращает данные в формате JSON (по умолчанию) или XML. Чтобы получить XML-ответ, передайте в запросе HTTP-заголовок Accept: application/xml
.
{
"valid_until": "YYYY-MM-DDThh:mm:ss±hh:mm",
"upload_address": "string"
}
<Data>
<valid_until>YYYY-MM-DDThh:mm:ss±hh:mm</valid_until>
<upload_address>string</upload_address>
</Data>
|
Дата и время, до которого адрес доступен для загрузки (10 минут после запроса). |
|
Ссылка для создания задачи на загрузку RSS-канала. |
Коды ответа
Код |
Описание |
||||||
200 OK |
Запрос выполнен успешно. |
||||||
403 Forbidden |
INVALID_USER_ID ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже Пример ответа
|
||||||
404 Not Found |
HOST_NOT_VERIFIED Не подтверждены права на управление сайтом. Пример ответа
|
Пример
Запрос:
curl -X GET \
'https://api.webmaster.yandex.net/v4/user/12345678/hosts/https:example.com:443/turbo/uploadAddress?mode=PRODUCTION' \
-H 'Authorization: OAuth oauth_token'
Ответ:
{
"valid_until": "2018-11-10T18:12:22.085+03:00",
"upload_address": "https://api.webmaster.yandex.net/v3.2/upload/turbo/yXOkhVGtFtUiZfRBJxIivnlHW90o5jrpBhFSjnGg_yMyg7tYc9sGsOtDSkaGQx-N_2i_2bQxgvUk1gbxreD_uA"
}
Идентификатор задачи на загрузку RSS-канала. Доступен при создании задачи на загрузку RSS-канала или при получении списка ранее созданных задач.
Идентификатор пользователя. Значение можно получить с помощью операции GET /v4/user.
Идентификатор сайта. Имеет формат scheme:host:port
, где
-
scheme
— протоколhttp
илиhttps
. -
host
— адрес сайта сwww
или без. -
port
— порт для подключения. Для протоколаhttp
— 80, дляhttps
— 443.
Например: https:example.com:443
или http:www.example.com:80
.
Также идентификатор сайта можно получить с помощью операции GET /user/{user-id}/hosts.
Режим загрузки RSS-канала. Возможные значения:
-
PRODUCTION
— публикация. -
DEBUG
— режим отладки.
Значение по умолчанию: PRODUCTION
.
Обязательный параметр