# הגדרת Felo API

הגדירו את נקודות הקצה של Felo ב-Data API עבור חיפוש, תוכן אינטרנט, נתוני X ומצגות, באמצעות יתרת הפלטפורמה.

Felo הוא אחד הספקים ב-[Data API](https://openapi.felo.ai/he/docs/data-api), ומציע חיפוש באינטרנט, קריאת אינטרנט, נתוני X, תשובות מבוססות חיפוש ומצגות. מצאו כל נקודת קצה של Felo לצד ספקים אחרים בקטגוריית Data API הרלוונטית.

נקודות קצה אלו משתמשות ב-**יתרת הפלטפורמה** ובקידומת `/api/v1/data`. מדריך זה מסביר אימות, את הבקשה הראשונה שלכם והיכן למצוא כללי חיוב.

כדי להשתמש ב-Felo Pro credits, ראו את [Felo APIs הקיימים](https://openapi.felo.ai/he/docs/api-reference/felo-apis.md). יתרת הפלטפורמה ו-Felo Pro credits הן נפרדות.

## בצעו את הבקשה הראשונה שלכם

1. צרו מפתח ב-[Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. בדקו או הטעינו את **יתרת הפלטפורמה** שלכם ב-[Console → Billing](https://openapi.felo.ai/console/billing).
3. הגדירו את המפתח בשרת שלכם או במעטפת המקומית:

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

שלחו `Authorization: Bearer $FELO_API_KEY`. גם `X-API-Key` מתקבל; בחרו שיטת אימות אחת. בקשות JSON צריכות `Content-Type: application/json`.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is retrieval augmented generation?","count":3}'
```

HTTP 200 מחזיר מערך `resources` עם כותרות דפים, קישורים וקטעים, וכן `total`. הוא אינו מייצר תשובה שיחתית; לצורך זה השתמשו ב-[Chat](https://openapi.felo.ai/he/docs/data-api/guides/felo-chat.md).

## עיינו ב-APIs

| מדריך | פעולות | מה תקבלו | יחידת חיוב |
|---|---|---|---|
| [חיפוש אינטרנט](https://openapi.felo.ai/he/docs/data-api/guides/felo-web-search.md) | חיפוש באינטרנט | כותרות דפים, קישורים וקטעים | בקשה |
| [קריאת אינטרנט](https://openapi.felo.ai/he/docs/data-api/guides/felo-web-read.md) | קריאת URL | Markdown, טקסט, HTML או צילום מסך | בקשה |
| [נתוני X](https://openapi.felo.ai/he/docs/data-api/guides/felo-x-data.md) | פרופילים, חיפוש משתמשים, פוסטים של משתמש, חיפוש פוסטים, תגובות | משתמשים ופוסטים מובנים, עם דפדוף היכן שנתמך | תוצאה שהוחזרה |
| [צ'אט מבוסס-חיפוש](https://openapi.felo.ai/he/docs/data-api/guides/felo-chat.md) | מענה על שאלה | תשובה ומקורות אינטרנט | בקשה |
| [PPT](https://openapi.felo.ai/he/docs/data-api/guides/felo-ppt.md) | יצירה, סטטוס, תוצאות, ייצוא, סטטוס ייצוא, מחיקה | משימת יצירה ו-PPTX להורדה | עמוד שנוצר; הייצוא מחויב בנפרד |
| [חיוב ושגיאות](https://openapi.felo.ai/he/docs/data-api/guides/felo-billing.md) | הנחיות אינטגרציה משותפות | מחירים, טיפול ביתרה וכללי ניסיון חוזר | — |

ישנם **14 תהליכי ליבה** במדריכים אלה. אם יצירת PPT מחזירה `stream_key`, [מדריך PPT](https://openapi.felo.ai/he/docs/data-api/guides/felo-ppt.md#sse) מסביר גם כיצד לקרוא אירועי יצירה באמצעות SSE. שאילתות סטטוס ותוצאות, שאילתות סטטוס-ייצוא ומחיקה אינן יוצרות חיוב חדש.

## לפני העברת אינטגרציה קיימת

השתמשו במדריך של נקודת הקצה המדויקת שאתם קוראים. החלפת `/v2` ב-`/api/v1/data` אינה העברה מלאה:

- קריאת אינטרנט משתמשת ב-`/web/read`, עם פורמט פלט אחד לכל בקשה.
- Chat מחזיר `status: "ok"`; הוא תומך רק ב-JSON ללא סטרימינג.
- תוצאות PPT משתמשות ב-**POST** `/tasks/{task_id}/historical`.
- יצירת PPT מחזירה מזהים בשורש ה-JSON. שמרו גם את `task_id` וגם את `ppt_business_id`.
- מצגות PPT שנוצרו פגות לאחר שבעה ימים. ייצאו ושמרו את הקובץ לפני התפוגה.

אין כאן מקבילה מקורית מתועדת של OpenAPI לכל תהליך `/v2`, כגון CRUD של LiveDoc, Mindmap או SuperAgent. המשיכו להשתמש ב-[מדריכי Felo APIs](https://openapi.felo.ai/he/docs/api-reference/felo-apis.md) ובחיוב Pro-credit.

## החוזה והמחירים הנוכחיים

- [סכימת OpenAPI שפורסמה](https://openapi.felo.ai/api/v1/data/openapi.json) — הגדרות שדות וסכימות תגובה.
- [סכימת OpenAPI ב-YAML](https://openapi.felo.ai/api/v1/data/openapi.yaml) — לכלים שמקבלים YAML.
- [מחירים נוכחיים](https://openapi.felo.ai/api/v1/data/prices) — מזהי פעולות, יחידות חיוב ושיעורים נוכחיים.

משאבים אלו ציבוריים וניתן לקרוא אותם ללא מפתח. ראו [חיוב ושגיאות](https://openapi.felo.ai/he/docs/data-api/guides/felo-billing.md) לפני הוספת ניסיונות חוזרים אוטומטיים.