# خواندن وب

یک URL را به‌صورت Markdown، متن، HTML یا تصویر صفحه بخوانید.

یک صفحه وب مشخص را در قالبی که برنامه شما بتواند مصرف کند بخوانید.

تمام نمونه‌ها از `FELO_API_KEY` از [نمای کلی](https://openapi.felo.ai/fa/docs/data-api/guides/felo-overview.md) استفاده می‌کنند. تماس‌ها از **موجودی پلتفرم** استفاده می‌کنند، نه اعتبارات Felo Pro. نمونه‌های پاسخ صرفاً نمایشی هستند؛ محتوای زنده و فیلدهای اختیاری متفاوت‌اند.

## پایانه

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

## درخواست

| فیلد | نوع | الزامی | معنا |
|---|---|---|---|
| `url` | string | بله | URL صفحه HTTP یا HTTPS |
| `formats` | آرایه string | خیر | دقیقاً یکی از `MARKDOWN`، `TEXT`، `HTML`، `SCREENSHOT`; پیش‌فرض Markdown |
| `mode` | string | خیر | `quality` (پیش‌فرض)، `fast` یا `auto` |
| `timeout` | integer | خیر | زمان‌انتظار به میلی‌ثانیه، 1 تا 60,000؛ پیش‌فرض 30,000 |
| `totalTimeout` | integer | خیر | زمان‌انتظار کل به میلی‌ثانیه، 1 تا 60,000؛ پیش‌فرض `timeout` |

برای هر درخواست فقط یک قالب خروجی را انتخاب کنید؛ هر چهار را در یک آرایه ارسال نکنید.

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

## پاسخ

HTTP 200 فیلد محتوای انتخاب‌شده را در ریشه JSON برمی‌گرداند. یک پاسخ Markdown می‌تواند شبیه این باشد:

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

`markdown`، `text`، `html` یا `screenshot` را مطابق قالبی که درخواست کرده‌اید بخوانید. سایر فراداده‌ها اختیاری هستند؛ نیاز نیست همه فیلدهای قالب‌ها حاضر باشند. برای پاسخ کامل، اسکیما `WebReadResponse` را در [تعریف OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) ببینید.

## صورتحساب و خطاها

`web.read` بر اساس هر درخواست صورتحساب می‌شود. یک زمان‌اِتمام به معنای صفحه خالی نیست: پیش از استفاده از بدنه، وضعیت HTTP را بررسی کنید. پس از زمان‌اِتمام به درخواست‌های سریع و تکراری روی نیاورید؛ از [صورتحساب و خطاها](https://openapi.felo.ai/fa/docs/data-api/guides/felo-billing.md) پیروی کنید.