الانتقال إلى المحتوى الرئيسي

مقدمة

hCaptcha هي خدمة تحقق تقدمها Ace Data Cloud، وحل hCaptcha. من خلال واجهة برمجة التطبيقات الموحدة لـ Ace Data Cloud، يمكنك استخدام بايثون لدمج hCaptcha بسرعة، وتحقيق وظائف مثل الحصول على رمز hCaptcha والتعرف على صور hCaptcha.

المتطلبات الأساسية

  • امتلاك حساب في Ace Data Cloud والحصول على رمز API
  • بيئة بايثون 3.7 أو أعلى
  • تثبيت مكتبة requests: pip install requests

الاستخدام الأساسي

النقطة النهائية الرئيسية لاستدعاء API الخاصة بـ hCaptcha هي:
POST https://api.acedata.cloud/captcha/token/hcaptcha
مثال كامل على كود بايثون:
import requests

url = "https://api.acedata.cloud/captcha/token/hcaptcha"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2",
    "website_url": "https://accounts.hcaptcha.com/demo"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
يرجى استبدال YOUR_API_TOKEN بالرمز الفعلي الذي حصلت عليه من منصة Ace Data Cloud.

معالجة الاستجابة

بعد استدعاء ناجح، تعيد API بيانات بصيغة JSON. يُنصح بفحص رمز حالة HTTP:
if response.status_code == 200:
    result = response.json()
    print("تم الاستدعاء بنجاح:", result)
else:
    print(f"فشل الاستدعاء، رمز الحالة: {response.status_code}")
    print(response.text)

الاستخدام المتقدم

بالنسبة لـ API التي تدعم المهام غير المتزامنة، يمكن الحصول على النتائج عبر عنوان URL للتراجع (callback):
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# سيتم دفع النتائج إلى خادمك عبر عنوان URL للتراجع

معالجة الأخطاء

رموز الأخطاء الشائعة:
رمز الحالةالوصف
401فشل التوثيق، يرجى التحقق من رمز API
403رصيد غير كافٍ أو عدم وجود صلاحية الوصول
429تجاوز معدل الطلبات المسموح به
500خطأ داخلي في الخادم

نقاط نهاية أخرى

توفر خدمة hCaptcha أيضًا النقاط النهائية التالية:
  • POST https://api.acedata.cloud/captcha/recognition/hcaptcha

الخطوة التالية