---
metadata:
- name: generator
content: Diplodoc Platform v5.44.0
alternate:
- https://yandex.com/dev/webmaster/doc/ru/reference/host-id-important-archive-all-pages.md
keywords:
- а
- р
- х
- и
- в
- ' '
- с
- е
- т
- н
- ц
- й
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/webmaster/doc/ru/llms.txt
# Выгрузка архива всех страниц сайта
Возвращает архив c информацией о страницах, которые были добавлены в Sitemap.
Скачать архив можно в Вебмастере на странице **Индексирование** → **Все страницы**.
Чтобы скачать архив:
1. С помощью POST-запроса начните формирование архива.
В зависимости от размера архива процесс может занять от 10 секунд до 3 минут. В результате вы получите `task_id`— уникальный идентификатор задачи по формированию архива.
1. C помощью GET-запроса проверьте статус задачи.
## Форматы запросов {#request-format}
{% list tabs %}
- POST
```
POST https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/indexing/archive/
```
#|
||
`user-id`
|
Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://yandex.com/dev/webmaster/doc/ru/reference/user.md).
||
||
`host-id`
|
Тип: `string`. ID сайта. Чтобы получить его, используйте метод [GET /v4/user/{user‑id}/hosts](https://yandex.com/dev/webmaster/doc/ru/reference/hosts.md).
||
|#
- GET
```
GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/indexing/archive/{task-id}
```
#|
||
`user-id`
|
Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://yandex.com/dev/webmaster/doc/ru/reference/user.md).
||
||
`host-id`
|
Тип: `string`. ID сайта. Чтобы получить его, используйте метод [GET /v4/user/{user‑id}/hosts](https://yandex.com/dev/webmaster/doc/ru/reference/hosts.md).
||
||
`task-id`
|
Тип: `UUID`. ID задачи на формирование архива.
||
|#
{% endlist %}
## Форматы ответов {#response-format}
{% list tabs %}
- POST
>
> JSON
>
>
> ```javascript
> {
> "task_id": "c7fe80c0-36e3-11e6-8b2d-df96aa592c0a"
> }
> ```
> #|
> ||
> **Параметр**
> |
> **Обязательный**
> |
> **Тип**
> |
> **Описание**
> ||
> ||
> `task_id`
> |
> Да
> |
> `string`
> |
> Идентификатор задачи формирования архива.
> ||
>|#
- GET
>
> JSON
>
>
> ```javascript
> {
> "task_id": "c7fe80c0-36e3-11e6-8b2d-df96aa592c0a",
> "state": "DONE",
> "download_url": "https://storage.mds.yandex.net/..."
> }
> ```
> #|
> ||
> **Параметр**
> |
> **Обязательный**
> |
> **Тип**
> |
> **Описание**
> ||
> ||
> `task_id`
> |
> Да
> |
> `string`
> |
> Идентификатор задачи формирования архива.
> ||
> ||
> `state`
> |
> Да
> |
> `string`
> |
> Cтатус задачи. Возможные значения:
> - `IN_PROGRESS` — архив формируется. Периодически отправляйте GET-запросы, чтобы следить за выполнением задачи.
> - `DONE` — архив сформирован. В поле `download_url` появится ссылка для скачивания.
> - `FAILED` — задача не выполнена по какой-либо причине.
> ||
> ||
> `download_url`
> |
> Да
> |
> `string`
> |
> URL-адрес для скачивания архива, если задача имеет статус `DONE`.
> ||
> |#
{% endlist %}
## Коды ответа {#errors}
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
{% list tabs %}
- Для POST-запроса
#|
||
**Код**
|
**Причина**
|
**Описание**
||
||
403
|
[INVALID_USER_ID](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#invalid-user-id)
|
ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже `{user_id}` указан правильный `uid` владельца OAuth-токена.
{% list tabs %}
- JSON
```json
{
"error_code": "INVALID_USER_ID",
"available_user_id": 1,
"error_message": "Invalid user id. {user_id} should be used."
}
```
- XML
```xml
<[error_code](*error_code)>INVALID_USER_ID
<[available_user_id](*available_user_id)>1
<[error_message](*error_message)>Invalid user id. {user_id} should be used.
```
{% endlist %}
||
||
404
|
[HOST_NOT_VERIFIED](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#host-not-verif)
|
Не подтверждены права на управление сайтом.
{% list tabs %}
- JSON
```json
{
"error_code": "HOST_NOT_VERIFIED",
"host_id": "http:ya.ru:80",
"error_message": "some string"
}
```
- XML
```xml
<[error_code](*error_code)>HOST_NOT_VERIFIED
<[host_id](*host_id)>http:ya.ru:80
<[error_message](*error_message)>some string
```
{% endlist %}
|#
- Для GET-запроса
#|
||
**Код**
|
**Причина**
|
**Описание**
||
||
403
|
[INVALID_USER_ID](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#invalid-user-id)
|
ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже `{user_id}` указан правильный `uid` владельца OAuth-токена.
{% list tabs %}
- JSON
```json
{
"error_code": "INVALID_USER_ID",
"available_user_id": 1,
"error_message": "Invalid user id. {user_id} should be used."
}
```
- XML
```xml
<[error_code](*error_code)>INVALID_USER_ID
<[available_user_id](*available_user_id)>1
<[error_message](*error_message)>Invalid user id. {user_id} should be used.
```
{% endlist %}
||
||
404
|
[HOST_NOT_VERIFIED](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#host-not-verif)
|
Не подтверждены права на управление сайтом.
{% list tabs %}
- JSON
```json
{
"error_code": "HOST_NOT_VERIFIED",
"host_id": "http:ya.ru:80",
"error_message": "some string"
}
```
- XML
```xml
<[error_code](*error_code)>HOST_NOT_VERIFIED
<[host_id](*host_id)>http:ya.ru:80
<[error_message](*error_message)>some string
```
{% endlist %}
||
||
404
|
[TASK_NOT_FOUND](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#task-not-found)
|
Не найдена задача с указанным ID.
{% list tabs %}
- JSON
```javascript
{
"error_code": "TASK_NOT_FOUND",
"error_message": "some string"
}
```
- XML
```xml
<[error_code](*error_code)>TASK_NOT_FOUND
<[error_message](*error_message)>some string
```
{% endlist %}
||
|#
{% endlist %}
#### Узнайте больше
- [Коды ошибок и статусы](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md)