Capzy Data API. اختر مصدرك.
اعثر على نقطة نهاية لموقع مدعوم، وأرسل معاملاتها، واستلم JSON. استكشف المرجع هنا، ثم شغّل الطلبات وافحصها في بيئة التجربة بلوحة التحكم.
بحث Amazon، في لمحة
GET /v1/amazon/searchمثال توضيحي
اعثر على المصدر الذي تحتاجه
لكل مصدر نقاط نهايته ومدخلاته المطلوبة وبنية استجابته الخاصة. افتح مرجعه للتحقق من التغطية قبل بناء التكامل.
جميع المصادر (83)
أول طلب لك على Data API
يستخدم مثال Amazon هذا نقطة نهاية GET خاصة بالمصدر. تُرجع HTTP 200 بيانات المصدر؛ وتُرجع HTTP 202 حالة انتظار وjobId. افحص المهام المعلّقة في صفحة عمليات التشغيل بلوحة تحكم Data API قبل إرسال طلب آخر.
أنشئ مفتاح Data API
افتح لوحة تحكم Data API لنسخ مفتاح Data API المخصص لك. يُستخدم رصيد الخطة أولًا؛ ويُخصم الاستخدام الإضافي من رصيد حساب Capzy المشترك.
افتح Data APIاختر المصدر والإجراء
استخدم مرجع الموقع لمعرفة الطريقة والمسار والمعاملات المطلوبة. يرسل مثال بحث Amazon القيمتين query وdomain إلى /v1/amazon/search.
اقرأ معاملات بحث Amazonافحص JSON في بيئة التجربة
افتح المصدر المطابق في لوحة التحكم، واختر الإجراء، واملأ مدخلاته وشغّل طلبًا. تحقّق من السعر الحالي لنقطة النهاية قبل التشغيل.
افتح بيئة تجربة بحث Amazon
# Install: pip install requests
import os
import requests
response = requests.get(
"https://api.capzy.ai/v1/amazon/search",
headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
params={"query": "wireless earbuds", "domain": "com"},
timeout=120,
)
response.raise_for_status()
data = response.json()
if response.status_code == 202:
print("Pending:", data.get("status"), "Job:", data.get("jobId"))
print("Inspect this job in https://capzy.ai/dashboard/data-api/runs")
else:
for item in data.get("organic_results", []):
print(item["title"], item.get("price"))
print("Credits used:", response.headers.get("X-Credits-Used"))اعرف العقد قبل الاستدعاء
المصادقة مشتركة بين مصادر Data API. أما الطرق والمعاملات والحقول المُرجعة فتخص كل نقطة نهاية.
X-API-Keyمطلوب · ترويسة- أرسل مفتاح Data API المخصص لك في هذه الترويسة. احتفظ به على الخادم واقرأه من CAPZY_DATA_API_KEY في هذه الأمثلة.
/v1/{source}/{path}خاص بنقطة النهاية · المسار- اتبع الطريقة والمسار في مرجع المصدر. على سبيل المثال، تأخذ GET /v1/amazon/search القيمتين query وdomain كمعاملات استعلام.
X-Credits-Usedترويسة الاستجابة- افحص الرصيد المخصوم للطلب. تُعرض أسعار نقاط النهاية وخصومات الخطط في لوحة التحكم ومرجع المصدر.
X-Next-Cursorترويسة الاستجابة · عند وجودها- تُرجع بعض نقاط النهاية مؤشرًا للصفحة التالية. استخدم معاملات ترقيم الصفحات الخاصة بكل نقطة نهاية؛ فلا تستخدم كل المصادر نموذج ترقيم الصفحات نفسه.
استخدم حقول الاستجابة الفعلية للمصدر
تكشف استجابة بحث Amazon بحالة HTTP 200 عن organic_results في المستوى الأعلى. أما HTTP 202 فتُرجع بدلًا من ذلك غلاف حالة مع jobId؛ افحصه في صفحة عمليات التشغيل بلوحة التحكم. تستخدم هذه الاستجابة الناجحة المختصرة بيانات منتجات توضيحية.
{
"search_information": {
"query": "wireless earbuds"
},
"organic_results": [
{
"title": "Example wireless earbuds",
"price": "$27.99",
"extracted_price": 27.99,
"asin": "EXAMPLE001"
}
]
}الأسعار
تتضمن خطط Data API حصة رصيد شهرية. يُخصم الاستخدام الإضافي من رصيد حساب Capzy المشترك. راجع مرجع المصدر لمعرفة السعر الحالي لنقطة النهاية بالرصيد.
جارٍ تحميل الأسعار الحالية…
أمور ينبغي معرفتها
أين تُفتح بيئة التجربة؟
في لوحة التحكم ← Data API ← أدوات الاستخراج. تفتح روابط المصادر أداة الإنشاء الخاصة بذلك المصدر. وتحدّد روابط نقاط النهاية الإجراء المطابق مسبقًا، لتتمكن من فحص المدخلات المطلوبة قبل التشغيل.
هل يمكنني استخدام مفتاح API لأدوات الحل؟
استخدم مفتاح Data API المخصص المعروض في لوحة تحكم Data API. لـ Data API عناصر تحكم خطة خاصة ورصيد مضمّن، بينما يُموَّل الاستخدام الإضافي من رصيد حساب Capzy المشترك.
هل تُرجع كل المصادر JSON نفسه؟
لا. لكل نقطة نهاية بنية استجابة خاصة بمصدرها. افحص الاستجابة الموثّقة وتعامل مع الحقول المفقودة أو الاختيارية في تطبيقك.
ماذا لو كانت نقطة النهاية قادمة قريبًا؟
تميّز لوحة التحكم نقاط النهاية غير المتحقق منها أو غير المتاحة للتشغيل. استخدم الإجراءات المدعومة المعروضة هناك؛ فوجود إدخال في المرجع وحده لا يعني أن نقطة النهاية جاهزة.
اعثر على مصدر. جرّب طلبًا حقيقيًا.
تجمع بيئة التجربة في لوحة التحكم بين المدخلات والاستجابة والأسعار الحالية.
