# Baca Web

Baca URL sebagai Markdown, teks, HTML atau tangkapan skrin.

Baca halaman web tertentu dalam format yang boleh digunakan oleh aplikasi anda.

Semua contoh menggunakan `FELO_API_KEY` daripada [gambaran keseluruhan](https://openapi.felo.ai/ms/docs/data-api/guides/felo-overview.md). Panggilan menggunakan **baki platform**, bukan kredit Felo Pro. Contoh respons adalah ilustratif; kandungan langsung dan medan pilihan berbeza.

## Titik akhir

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

## Permintaan

| Medan | Jenis | Diperlukan | Makna |
|---|---|---|---|
| `url` | string | Ya | URL halaman HTTP atau HTTPS |
| `formats` | tatasusunan string | Tidak | Tepat satu daripada `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; lalai kepada Markdown |
| `mode` | string | Tidak | `quality` (lalai), `fast` atau `auto` |
| `timeout` | integer | Tidak | Had masa dalam milisaat, 1–60,000; lalai 30,000 |
| `totalTimeout` | integer | Tidak | Had masa keseluruhan dalam milisaat, 1–60,000; lalai kepada `timeout` |

Pilih satu format output bagi setiap permintaan; jangan hantar kesemua empat dalam tatasusunan yang sama.

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

## Respons

HTTP 200 memulangkan medan kandungan yang dipilih pada akar JSON. Respons Markdown boleh kelihatan seperti:

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

Baca `markdown`, `text`, `html` atau `screenshot` mengikut format yang anda minta. Metadata lain adalah pilihan; jangan memerlukan setiap medan format hadir. Lihat skema `WebReadResponse` dalam [definisi OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) untuk respons lengkap.

## Pengebilan dan kegagalan

`web.read` dibilkan bagi setiap permintaan. Had masa tamat bukan halaman kosong: semak status HTTP sebelum menggunakan isi badan. Jangan beralih kepada permintaan berulang pantas selepas had masa tamat; ikut [Pengebilan dan Ralat](https://openapi.felo.ai/ms/docs/data-api/guides/felo-billing.md).