# Felo Odczyt stron internetowych

POST /api/v1/data/web/read

Odczytaj konkretną stronę internetową w formacie, który może być użyty przez twoją aplikację.

Wszystkie przykłady używają `FELO_API_KEY` z [przeglądu](https://openapi.felo.ai/pl/docs/data-api/guides/felo-overview.md). Wywołania korzystają z **salda platformy**, a nie z kredytów Felo Pro. Przykłady odpowiedzi mają charakter poglądowy; rzeczywista treść i opcjonalne pola mogą się różnić.

## Punkt końcowy

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

## Żądanie

| Pole | Typ | Wymagane | Znaczenie |
|---|---|---|---|
| `url` | string | Tak | Adres URL strony HTTP lub HTTPS |
| `formats` | tablica stringów | Nie | Dokładnie jedno z: `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; domyślnie Markdown |
| `mode` | string | Nie | `quality` (domyślnie), `fast` lub `auto` |
| `timeout` | integer | Nie | Limit czasu w milisekundach, 1–60 000; domyślnie 30 000 |
| `totalTimeout` | integer | Nie | Całkowity limit czasu w milisekundach, 1–60 000; domyślnie `timeout` |

Wybierz jeden format wyjściowy na żądanie; nie wysyłaj wszystkich czterech w tej samej tablicy.

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

## Odpowiedź

HTTP 200 zwraca wybrane pole treści w korzeniu JSON. Odpowiedź Markdown może wyglądać tak:

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

Odczytaj `markdown`, `text`, `html` lub `screenshot` zgodnie z wybranym formatem. Inne metadane są opcjonalne; nie wymagaj obecności każdego pola formatu. Zobacz schemat `WebReadResponse` w [definicji OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json), aby poznać pełną odpowiedź.

## Rozliczenia i błędy

`web.read` jest rozliczany za żądanie. Limit czasu nie oznacza pustej strony: sprawdź status HTTP przed użyciem treści odpowiedzi. Nie przechodź na wielokrotne, szybkie żądania po przekroczeniu limitu czasu; postępuj zgodnie z [Rozliczeniami i błędami](https://openapi.felo.ai/pl/docs/data-api/guides/felo-billing.md).