# Felo Čtení webových stránek

POST /api/v1/data/web/read

Načtěte konkrétní webovou stránku ve formátu, který vaše aplikace dokáže zpracovat.

Všechny příklady používají `FELO_API_KEY` z [přehledu](https://openapi.felo.ai/cs/docs/data-api/guides/felo-overview.md). Volání používají **zůstatek platformy**, nikoli Felo Pro credits. Příklady odpovědí jsou ilustrativní; živý obsah a volitelná pole se liší.

## Konečný bod

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

## Požadavek

| Pole | Typ | Povinné | Význam |
|---|---|---|---|
| `url` | string | Ano | URL stránky HTTP nebo HTTPS |
| `formats` | pole stringů | Ne | Přesně jedno z `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; výchozí je Markdown |
| `mode` | string | Ne | `quality` (výchozí), `fast` nebo `auto` |
| `timeout` | integer | Ne | Časový limit v milisekundách, 1–60 000; výchozí 30 000 |
| `totalTimeout` | integer | Ne | Celkový časový limit v milisekundách, 1–60 000; výchozí `timeout` |

Vyberte jeden výstupní formát na požadavek; neposílejte všechny čtyři ve stejném poli.

```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}'
```

## Odpověď

HTTP 200 vrací vybrané obsahové pole v kořeni JSON. Odpověď v Markdownu může vypadat takto:

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

Přečtěte `markdown`, `text`, `html` nebo `screenshot` podle formátu, který jste požadovali. Ostatní metadata jsou volitelná; nevyžadujte přítomnost každého formátového pole. Úplnou odpověď najdete ve schématu `WebReadResponse` v [definici OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).

## Účtování a selhání

`web.read` je účtováno za požadavek. Vypršení času není prázdná stránka: před použitím těla zkontrolujte HTTP stav. Po timeoutu nepřecházejte na opakované rychlé požadavky; řiďte se [Účtováním a chybami](https://openapi.felo.ai/cs/docs/data-api/guides/felo-billing.md).