# Web Okuma

Bir URL’yi Markdown, metin, HTML veya ekran görüntüsü olarak okuyun.

Uygulamanızın tüketebileceği bir biçimde belirli bir web sayfasını okuyun.

Tüm örnekler [genel bakış](https://openapi.felo.ai/tr/docs/data-api/guides/felo-overview.md) içindeki `FELO_API_KEY`’i kullanır. Çağrılar Felo Pro kredilerini değil, **platform bakiyesini** kullanır. Yanıt örnekleri açıklayıcıdır; canlı içerik ve isteğe bağlı alanlar değişebilir.

## Uç nokta

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

## İstek

| Alan | Tür | Gerekli | Anlamı |
|---|---|---|---|
| `url` | string | Evet | HTTP veya HTTPS sayfa URL’si |
| `formats` | string array | Hayır | Tam olarak bir tane: `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; varsayılan Markdown’dır |
| `mode` | string | Hayır | `quality` (varsayılan), `fast` veya `auto` |
| `timeout` | integer | Hayır | Milisaniye cinsinden zaman aşımı, 1–60.000; varsayılan 30.000 |
| `totalTimeout` | integer | Hayır | Milisaniye cinsinden toplam zaman aşımı, 1–60.000; varsayılan `timeout` |

Her istek için yalnızca bir çıktı biçimi seçin; dört biçimin hepsini aynı dizide göndermeyin.

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

## Yanıt

HTTP 200, seçilen içerik alanını JSON kökünde döndürür. Bir Markdown yanıtı şöyle görünebilir:

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

İstediğiniz biçime göre `markdown`, `text`, `html` veya `screenshot` okuyun. Diğer meta veriler isteğe bağlıdır; her biçim alanının bulunmasını zorunlu kılmayın. Tam yanıt için [OpenAPI tanımındaki](https://openapi.felo.ai/api/v1/data/openapi.json) `WebReadResponse` şemasına bakın.

## Faturalandırma ve hatalar

`web.read` istek başına faturalandırılır. Zaman aşımı boş sayfa değildir: gövdeyi kullanmadan önce HTTP durumunu kontrol edin. Zaman aşımından sonra tekrarlayan hızlı isteklere geçmeyin; [Faturalandırma ve Hatalar](https://openapi.felo.ai/tr/docs/data-api/guides/felo-billing.md) bölümünü izleyin.