Веб-поиск и чтение страниц
Собственный веб-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 | Поиск с выдержками |
POST, OPTIONS | /web-fetch/api/v1/fetch | Содержимое одной страницы |
OPTIONS выполняет CORS preflight для соответствующего пути, не требует ключа и возвращает статус-код 204 без тела.
Формат вызовов
Для POST передавайте Authorization: Bearer sk-ci2-... и JSON-тело. Все поля запроса обязательны, неизвестные поля отклоняются со статус-кодом 400. Потокового ответа нет.
Поле provider выбирает вариант поиска или чтения. Публичные имена okhta и karpovka одинаковы для обеих операций. Примеры используют okhta. Недоступный вариант отвечает 503; доступность karpovka зависит от включения соответствующего сервиса.
Поиск возвращает search_id и results. Чтение — fetch_id, метаданные и content. Идентификаторы в обоих ответах принадлежат запросу хаба. Полное описание всех полей находится на страницах поиска и чтения.
Запрос резервирует средства до обращения к сервису и рассчитывается по результату. Цены опубликованы на странице «Тарифы».
Ошибки
Ошибки параметров используют JSON с одной строкой error:
{"error":"objective must not be empty"}
Ошибки с HTTP 5xx, сформированные веб-API, имеют общее сообщение:
{"error":"web request failed"}
Недействительный ключ возвращает статус-код 401 без тела; общие ошибки авторизации, баланса и лимита расходов описаны в общем справочнике, ограничения размера запроса — на странице «Лимиты и ограничения».
Чтение может вернуть HTTP 200 с непустым полем error, если не удалось получить отдельную страницу. Такой результат отличается от ошибки всего API-вызова; его поля описаны на странице чтения.
