# קריאת אינטרנט

קרא URL כ-Markdown, טקסט, HTML או צילום מסך.

קראו דף אינטרנט מסוים בפורמט שהאפליקציה שלכם יכולה לצרוך.

כל הדוגמאות משתמשות ב-`FELO_API_KEY` מתוך [הסקירה הכללית](https://openapi.felo.ai/he/docs/data-api/guides/felo-overview.md). הקריאות משתמשות ב-**יתרת הפלטפורמה**, ולא ב-Felo Pro credits. דוגמאות התגובה הן להמחשה; תוכן חי ושדות אופציונליים משתנים.

## נקודת קצה

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

## בקשה

| שדה | סוג | נדרש | משמעות |
|---|---|---|---|
| `url` | string | כן | כתובת דף 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/he/docs/data-api/guides/felo-billing.md).