خواندن وب
ارائه‌دهنده: Felo · پرداخت با موجودی پلتفرم
یک صفحه وب مشخص را در قالبی که برنامه شما بتواند مصرف کند بخوانید.
تمام نمونه‌ها از FELO_API_KEY از نمای کلی استفاده می‌کنند. تماس‌ها از موجودی پلتفرم استفاده می‌کنند، نه اعتبارات 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 |
برای هر درخواست فقط یک قالب خروجی را انتخاب کنید؛ هر چهار را در یک آرایه ارسال نکنید.
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 را بررسی کنید. پس از زمان‌اِتمام به درخواست‌های سریع و تکراری روی نیاورید؛ از صورتحساب و خطاها پیروی کنید.