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

Читайте URL как Markdown, текст, HTML или снимок экрана.

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

Во всех примерах используется `FELO_API_KEY` из [обзора](https://openapi.felo.ai/ru/docs/data-api/guides/felo-overview.md). Вызовы используют **баланс платформы**, а не кредиты Felo Pro. Примеры ответов носят иллюстративный характер; фактический контент и необязательные поля могут отличаться.

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

`POST /api/v1/data/web/read`

## Запрос

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

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

```bash
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 может выглядеть так:

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

Читайте `markdown`, `text`, `html` или `screenshot` в соответствии с запрошенным форматом. Другие метаданные необязательны; не требуйте присутствия каждого поля формата. Полная схема ответа находится в `WebReadResponse` в [определении OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).

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

`web.read` тарифицируется за запрос. Тайм-аут — это не пустая страница: перед использованием тела ответа проверьте HTTP-статус. После тайм-аута не переходите к повторным быстрым запросам; следуйте [Биллинг и ошибки](https://openapi.felo.ai/ru/docs/data-api/guides/felo-billing.md).