Getting the uploads list
Returns the list of uploaded RSS feeds for the last month.
Request format
GET https://api.webmaster.yandex.net/v3.2/user/{user-id}/hosts/{host-id}/turbo/tasks
? [task_type_filter=<string>]
& [load_status_filter=<string>]
& [offset=<int32>]
& [limit=<int32>]
user-id | User ID. To get the value, use the GET /v4/user operation. |
host-id | Site ID. Has the scheme:host:port format, where
For example: You can also get the site ID using the operation GET /user/{user-id}/hosts. |
user-id | User ID. To get the value, use the GET /v4/user operation. |
host-id | Site ID. Has the scheme:host:port format, where
For example: You can also get the site ID using the operation GET /user/{user-id}/hosts. |
task_type_filter | Filter by the RSS feed upload mode. Possible values:
For example, filtering by DEBUG mode returns a list of tasks in the debug mode. |
load_status_filter | Filter by the RSS feed upload status. Possible values:
For example, filter by the PROCESSING status returns a list of tasks with the processing status. |
offset | Offset in the list. The minimum value is 0. The offset query parameter can be used together with the limit parameter, for example, to add pagination. |
limit | Maximum list items number. The minimum value is 1; the maximum value is 100. The default value is 100. |
task_type_filter | Filter by the RSS feed upload mode. Possible values:
For example, filtering by DEBUG mode returns a list of tasks in the debug mode. |
load_status_filter | Filter by the RSS feed upload status. Possible values:
For example, filter by the PROCESSING status returns a list of tasks with the processing status. |
offset | Offset in the list. The minimum value is 0. The offset query parameter can be used together with the limit parameter, for example, to add pagination. |
limit | Maximum list items number. The minimum value is 1; the maximum value is 100. The default value is 100. |
Response format
The service returns data in either JSON (default) or XML format. To get the XML response, pass the HTTP header Accept: application/xml
in the request.
{
"tasks": [
{
"task_id": "string",
"created_at": "YYYY-MM-DDThh:mm:ss±hh:mm",
"load_status": "string"
},
...
],
"count": 1
}
<Data>
<task>
<task_id>string</task_id>
<created_at>2016-01-01T00:00:00,000+0300</created_at>
<load_status>PROCESSING</load_status>
</task>
<task>
...
</task>
<count>int32</count>
</Data>
task_id
created_at
load_status
- PROCESSING — The file is validated for errors.
- OK —The file is uploaded and doesn't contain errors.
- WARNING — XML elements in the file aren't supported by Yandex or are specified incorrectly.
- ERROR — The file contains errors (for example, duplicate XML elements).
count
Response codes
Code | Description |
---|---|
200 OK | The request is successfully completed. |
403 Forbidden |
|
404 Not Found |
|
Code | Description |
---|---|
200 OK | The request is successfully completed. |
403 Forbidden |
|
404 Not Found |
|
Example
Request:
curl -X GET \ 'https://api.webmaster.yandex.net/v3.2/user/12345678/hosts/https:example.com:443/turbo/tasks' \ -H 'Authorization: OAuth oauth_token'
Copied to clipboard
Response:
{
"tasks": [
{
"task_id": "49a8f860-ebf7-11e8-b31a-ed044935f842",
"created_at": "2018-11-19T15:33:16.006+03:00",
"load_status": "OK"
}
]
}