# قراءة الويب

اقرأ عنوان URL بصيغة Markdown أو نص أو HTML أو لقطة شاشة.

اقرأ صفحة ويب محددة بصيغة يمكن لتطبيقك استهلاكها.

تستخدم جميع الأمثلة `FELO_API_KEY` من [نظرة عامة](https://openapi.felo.ai/ar/docs/data-api/guides/felo-overview.md). تستخدم الاستدعاءات **رصيد المنصة**، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.

## نقطة النهاية

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

## الطلب

| الحقل | النوع | مطلوب | المعنى |
|---|---|---|---|
| `url` | string | نعم | عنوان URL لصفحة HTTP أو HTTPS |
| `formats` | string array | لا | واحد فقط من `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/ar/docs/data-api/guides/felo-billing.md).