# Веб-поиск и чтение страниц

Адреса собственного API хаба для веб-поиска и чтения страниц, форматы ответов и ошибок.

Собственный веб-API хаба возвращает результаты поиска и содержимое страницы. Для обеих операций используется ключ хаба и его баланс.

## API методы

У операций разные базовые адреса: `https://hub.coreinfra.ai/web-search/api/v1` для поиска и `https://hub.coreinfra.ai/web-fetch/api/v1` для чтения. Общего префикса `/web/api/v1` нет.

| Методы            | Полный путь                 | Назначение                                                                    |
| ----------------- | --------------------------- | ----------------------------------------------------------------------------- |
| `POST`, `OPTIONS` | `/web-search/api/v1/search` | [Поиск с выдержками](https://coreinfra.ru/docs/reference/web/search.md)       |
| `POST`, `OPTIONS` | `/web-fetch/api/v1/fetch`   | [Содержимое одной страницы](https://coreinfra.ru/docs/reference/web/fetch.md) |

`OPTIONS` выполняет CORS preflight для соответствующего пути, не требует ключа и возвращает статус-код `204` без тела.

## Формат вызовов

Для `POST` передавайте `Authorization: Bearer sk-ci2-...` и JSON-тело. Все поля запроса обязательны, неизвестные поля отклоняются со статус-кодом `400`. Потокового ответа нет.

Поле `provider` выбирает вариант поиска или чтения. Публичные имена `okhta` и `karpovka` одинаковы для обеих операций. Примеры используют `okhta`. Недоступный вариант отвечает `503`; доступность `karpovka` зависит от включения соответствующего сервиса.

Поиск возвращает `search_id` и `results`. Чтение — `fetch_id`, метаданные и `content`. Идентификаторы в обоих ответах принадлежат запросу хаба. Полное описание всех полей находится на страницах [поиска](https://coreinfra.ru/docs/reference/web/search.md) и [чтения](https://coreinfra.ru/docs/reference/web/fetch.md).

Запрос резервирует средства до обращения к сервису и рассчитывается по результату. Цены опубликованы на странице [«Тарифы»](https://hub.coreinfra.ai/pricing).

## Ошибки

Ошибки параметров используют JSON с одной строкой `error`:

```json
{"error":"objective must not be empty"}
```

Ошибки с HTTP `5xx`, сформированные веб-API, имеют общее сообщение:

```json
{"error":"web request failed"}
```

Недействительный ключ возвращает статус-код `401` без тела; общие ошибки авторизации, баланса и лимита расходов описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors), ограничения размера запроса — на странице [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).

Чтение может вернуть HTTP `200` с непустым полем `error`, если не удалось получить отдельную страницу. Такой результат отличается от ошибки всего API-вызова; его поля описаны на странице [чтения](https://coreinfra.ru/docs/reference/web/fetch.md#errors).
