BytePlus
Web search and page content retrieval.
جلب محتوى نظيف ومنظّم لعنوان URL.
جلب عنوان URL واحد وإرجاع محتوى صفحة نظيف ومنظّم — العنوان والنص الأساسي ووقت النشر. Url مطلوب. تغلّف الاستجابة ResponseMetadata.RequestId وكائن Result يحوي المحتوى المحلّل. استخدمه لاستخراج محتوى الصفحة الكامل لعناوين URL تملكها، وعادةً بالاقتران مع نتائج post_byteplus_web_search.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.0008 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. يجب عدم تطبيق مضاعفات المرجع مرة أخرى على مبالغ العملاء المسوّاة.
بيانات مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringUrlمطلوب
عنوان URL المراد جلبه. مطلوب.
- النوع: object200
اكتمل الجلب بنجاح. يحمل
Resultمحتوى الصفحة المنظّم.- النوع: objectResponse
Metadata بيانات وصفية لطلب المنبع.
- Actionالنوع: string
- Regionالنوع: string
- Requestالنوع: string
Id معرّف فريد لهذا الطلب.
- Serviceالنوع: string
- Versionالنوع: string
- النوع: objectResult
حمولة نتيجة الجلب.
- Dataالنوع: object
محتوى الصفحة المهيكل.
- Contentالنوع: string
Text نص الجسم النظيف المستخرج من الصفحة.
- Publishالنوع: integer
Time وقت النشر المكتشف بثواني يونكس (0 إذا كان غير معروف).
- Statusالنوع: integer
Code رمز حالة HTTP للصفحة المجلوبة.
- Titleالنوع: string
عنوان الصفحة.
- Urlالنوع: string
عنوان URL المجلوب.
- Logالنوع: string
Id معرّف سجل المنبع (يساوي ResponseMetadata.RequestId).
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
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"
}
}