# POST /fetch — чтение страницы

Все поля запроса и ответа чтения страницы через хаб, выбор содержимого, списание и ошибки.

`POST /web-fetch/api/v1/fetch` читает одну страницу целиком или выбирает из нее выдержки под заданную цель. Это собственный API хаба: поле `provider` выбирает вариант чтения, а все поля интерфейса описаны ниже.

```bash
curl https://hub.coreinfra.ai/web-fetch/api/v1/fetch \
  -H "Authorization: Bearer $COREINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"okhta","url":"https://example.com/","objective":""}'
```

Фрагмент структуры ответа; идентификатор и содержимое сокращены:

```json
{
  "fetch_id": "...",
  "url": "https://example.com/",
  "title": null,
  "publish_date": null,
  "content": "...",
  "error": ""
}
```

## Поля запроса и ответа

Это собственный интерфейс хаба; таблицы описывают весь запрос и ответ.

### Запрос

Все три поля обязательны, принимают строки и не имеют значений по умолчанию. Неизвестные поля отклоняются со статус-кодом `400`.

| Поле        | Значение                                                                                                                         |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `provider`  | Вариант чтения: `okhta` или `karpovka`; пустое или неизвестное имя отклоняется со статус-кодом `400`, недоступный сервис — `503` |
| `url`       | Один абсолютный URL со схемой `http` или `https` и именем хоста                                                                  |
| `objective` | Пустая строка запрашивает полный текст; непустая — выдержки под указанную цель                                                   |

Для полного текста передайте именно `""` в `objective`: строка из пробелов тоже выбирает режим выдержек. Для `okhta`, если полного текста нет, `content` составляется из доступных выдержек. Выдержки объединяются двумя переводами строки.

### Ответ

Успешный вызов возвращает JSON со статус-кодом `200`. Непустое поле `error` означает неудачное чтение страницы; оно может сопровождаться статус-кодом `200` или `502`.

| Поле           | Тип               | Значение                                                                    |
| -------------- | ----------------- | --------------------------------------------------------------------------- |
| `fetch_id`     | строка            | UUID запроса хаба                                                           |
| `url`          | строка            | Адрес полученного результата; при ошибке чтения — адрес из запроса          |
| `title`        | строка или `null` | Заголовок страницы                                                          |
| `publish_date` | строка или `null` | Дата публикации, если она есть в результате                                 |
| `content`      | строка            | Полный текст или объединенные выдержки                                      |
| `error`        | строка            | Пустая строка при успехе; `failed to fetch page` при ошибке чтения страницы |

Стоимость зависит от выбранного варианта чтения. Уже оплаченное использование может учитываться и при неудачном чтении страницы. Ответ не содержит `usage` или суммы списания. Цены — на странице [«Тарифы»](https://hub.coreinfra.ai/pricing).

## Ошибки

| Статус-код | Условие                                                                                                                |
| ---------- | ---------------------------------------------------------------------------------------------------------------------- |
| `400`      | Некорректный JSON, отсутствующее или неизвестное поле, пустой или неподдерживаемый `provider`, либо некорректный `url` |
| `502`      | Ошибка на стороне провайдера при чтении страницы                                                                       |
| `503`      | Выбранный сервис чтения временно недоступен                                                                            |

При ошибке отдельной страницы статус-код остается `200`. В ответе `error` равно `failed to fetch page`, `content` пуст, `title` и `publish_date` равны `null`, а `url` повторяет адрес из запроса.

Формат ошибок описан в [разделе веб-API](https://coreinfra.ru/docs/reference/web.md#errors); общие ошибки ключа, баланса, лимита расходов и размера запроса — в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors).
