Felo API PlatformFelo API Platform

Чтение веб-страниц

Поставщик: Felo · Оплачивается балансом платформы

Аутентификация и настройкаБиллинг и ошибки

Читайте конкретную веб-страницу в формате, который может использовать ваше приложение.

Во всех примерах используется FELO_API_KEY из обзора. Вызовы используют баланс платформы, а не кредиты Felo Pro. Примеры ответов носят иллюстративный характер; фактический контент и необязательные поля могут отличаться.

Конечная точка

POST /api/v1/data/web/read

Запрос

ПолеТипОбязательноЗначение
urlstringДаURL страницы HTTP или HTTPS
formatsstring arrayНетРовно одно из MARKDOWN, TEXT, HTML, SCREENSHOT; по умолчанию Markdown
modestringНетquality (по умолчанию), fast или auto
timeoutintegerНетТайм-аут в миллисекундах, 1–60,000; по умолчанию 30,000
totalTimeoutintegerНетОбщий тайм-аут в миллисекундах, 1–60,000; по умолчанию равен timeout

Выбирайте один выходной формат на запрос; не отправляйте все четыре в одном массиве.

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/read" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","formats":["MARKDOWN"],"mode":"quality","timeout":30000}'

Ответ

HTTP 200 возвращает выбранное поле контента в корне JSON. Ответ Markdown может выглядеть так:

{
  "title": "Example Domain",
  "markdown": "# Example Domain\n\nThis domain is for use in documentation examples.",
  "metadata": {}
}

Читайте markdown, text, html или screenshot в соответствии с запрошенным форматом. Другие метаданные необязательны; не требуйте присутствия каждого поля формата. Полная схема ответа находится в WebReadResponse в определении OpenAPI.

Биллинг и сбои

web.read тарифицируется за запрос. Тайм-аут — это не пустая страница: перед использованием тела ответа проверьте HTTP-статус. После тайм-аута не переходите к повторным быстрым запросам; следуйте Биллинг и ошибки.

Нужна помощь?