Felo API PlatformFelo API Platform
همه endpointهای BytePlus
v0.2.0-beta
OpenAPI 3.1.0

واکشی محتوای پاک و ساختاریافته برای یک URL.

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

BytePlus

​

Web search and page content retrieval.

BytePlus عملیات

واکشی محتوای پاک و ساختاریافته برای یک URL.

​

یک URL را واکشی کرده و محتوای صفحه پاک و ساختاریافته — عنوان، متن بدنه و زمان انتشار — را برمی‌گرداند. Url الزامی است. پاسخ ResponseMetadata.RequestId و یک شیء Result با محتوای تجزیه‌شده را دربر می‌گیرد. از آن برای استخراج محتوای کامل صفحه برای URLهایی که دارید استفاده کنید، معمولاً همراه با نتایج post_byteplus_web_search.

مرجع قیمت‌گذاری

  • اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
  • برآورد درخواست مرجع: 0.0008 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. ضریب‌های مرجع را نباید دوباره روی مبالغ تسویه‌شده مشتری اعمال کرد.

فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

بدنه
الزامی
application/json
  • Url
    نوع: string
    الزامی

    نشانی URL برای واکشی. الزامی.

پاسخ‌ها
  • 200
    نوع: object

    واکشی با موفقیت انجام شد. Result محتوای ساختاریافته صفحه را نگه می‌دارد.

    • ResponseMetadata
      نوع: object

      فراداده درخواست بالادست.

      • Action
        نوع: string
      • Region
        نوع: string
      • RequestId
        نوع: string

        شناسه یکتای این درخواست.

      • Service
        نوع: string
      • Version
        نوع: string
    • Result
      نوع: object

      محتوای نتیجه واکشی.

      • Data
        نوع: object

        محتوای ساختاریافته صفحه.

        • ContentText
          نوع: string

          متن بدنه پاک‌شده استخراج‌شده از صفحه.

        • PublishTime
          نوع: integer

          زمان انتشار تشخیص‌داده‌شده به ثانیه یونیکس (0 اگر نامشخص باشد).

        • StatusCode
          نوع: integer

          کد وضعیت HTTP صفحه واکشی‌شده.

        • Title
          نوع: string

          عنوان صفحه.

        • Url
          نوع: string

          نشانی URL واکشی‌شده.

      • LogId
        نوع: string

        شناسه لاگ بالادست (برابر با ResponseMetadata.RequestId).

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for post/v1/beta/byteplus/fetch
curl https://openapi.felo.ai/v1/beta/byteplus/fetch \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "Url": "https://example.com"
}'
{
  "ResponseMetadata": {
    "RequestId": "20260904155514D7EA140BFD77348BC3FC",
    "Action": "",
    "Version": "",
    "Service": "",
    "Region": ""
  },
  "Result": {
    "Data": {
      "StatusCode": 200,
      "Url": "https://example.com",
      "Title": "Example Domain",
      "PublishTime": 0,
      "ContentText": "This domain is for use in documentation examples without needing permission. Avoid use in operations.\nLearn more"
    },
    "LogId": "20260904155514D7EA140BFD77348BC3FC"
  }
}
Fetch clean, structured content for a URL.