Felo API PlatformFelo API Platform

قراءة Felo للويب

المزود: Felo · مدفوع برصيد المنصة

المصادقة والإعدادالفوترة والأخطاءدليل سير العمل الكامل

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

تستخدم جميع الأمثلة FELO_API_KEY من نظرة عامة. تستخدم الاستدعاءات رصيد المنصة، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.

نقطة النهاية

POST /api/v1/data/web/read

الطلب

الحقلالنوعمطلوبالمعنى
urlstringنعمعنوان URL لصفحة HTTP أو HTTPS
formatsstring arrayلاواحد فقط من MARKDOWN أو TEXT أو HTML أو SCREENSHOT; الافتراضي Markdown
modestringلاquality (الافتراضي) أو fast أو auto
timeoutintegerلاالمهلة بالمللي ثانية، 1–60,000؛ الافتراضي 30,000
totalTimeoutintegerلاإجمالي المهلة بالمللي ثانية، 1–60,000؛ الافتراضي هو timeout

اختر صيغة إخراج واحدة لكل طلب؛ لا ترسل الصيغ الأربع جميعًا في المصفوفة نفسها.

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 مثل:

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

اقرأ markdown أو text أو html أو screenshot وفقًا للصيغة التي طلبتها. البيانات الوصفية الأخرى اختيارية؛ فلا تشترط وجود كل حقل من حقول الصيغ. راجع مخطط WebReadResponse في تعريف OpenAPI للاستجابة الكاملة.

الفوترة والإخفاقات

يُفوتر web.read لكل طلب. المهلة ليست صفحة فارغة: تحقّق من حالة HTTP قبل استخدام الجسم. لا تتحول إلى طلبات متكررة سريعة بعد المهلة؛ اتبع الفوترة والأخطاء.

هل تحتاج إلى مساعدة؟