# Baca Web

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

Baca halaman web tertentu dalam format yang dapat dikonsumsi aplikasi Anda.

Semua contoh menggunakan `FELO_API_KEY` dari [gambaran umum](https://openapi.felo.ai/id/docs/data-api/guides/felo-overview.md). Panggilan menggunakan **saldo platform**, bukan kredit Felo Pro. Contoh respons bersifat ilustratif; konten langsung dan bidang opsional bervariasi.

## Endpoint

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

## Permintaan

| Bidang | Tipe | Wajib | Arti |
|---|---|---|---|
| `url` | string | Ya | URL halaman HTTP atau HTTPS |
| `formats` | string array | Tidak | Tepat satu dari `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; default ke Markdown |
| `mode` | string | Tidak | `quality` (default), `fast`, atau `auto` |
| `timeout` | integer | Tidak | Waktu habis dalam milidetik, 1–60.000; default 30.000 |
| `totalTimeout` | integer | Tidak | Waktu habis total dalam milidetik, 1–60.000; default ke `timeout` |

Pilih satu format keluaran per permintaan; jangan kirim keempatnya dalam array 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 mengembalikan bidang konten yang dipilih di root JSON. Respons Markdown dapat terlihat seperti:

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

Baca `markdown`, `text`, `html`, atau `screenshot` sesuai format yang Anda minta. Metadata lain bersifat opsional; jangan mewajibkan setiap bidang format harus ada. Lihat skema `WebReadResponse` dalam [definisi OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) untuk respons lengkap.

## Penagihan dan kegagalan

`web.read` ditagihkan per permintaan. Waktu habis bukan halaman kosong: periksa status HTTP sebelum menggunakan body. Jangan beralih ke permintaan cepat berulang setelah waktu habis; ikuti [Penagihan dan Kesalahan](https://openapi.felo.ai/id/docs/data-api/guides/felo-billing.md).