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

​
مقدمة

Image2Text هي خدمة التحقق من الرموز المرئية (Captcha) التي تقدمها Ace Data Cloud، للتعرف على رموز التحقق في الصور. من خلال API موحد من Ace Data Cloud، يمكنك استخدام بايثون لدمج Image2Text بسرعة، وتحقيق التعرف على رموز التحقق في الصور، وإدخال Base64، وإدخال URL وغيرها من الوظائف.

​
المتطلبات المسبقة

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

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

نقطة النهاية الرئيسية لاستدعاء Image2Text API هي: 
POST https://api.acedata.cloud/captcha/recognition/image2text
مثال كامل على كود بايثون: 
import requests

url = "https://api.acedata.cloud/captcha/recognition/image2text"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}

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 رد الاتصال: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# سيتم دفع النتائج إلى خادمك عبر URL رد الاتصال

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

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

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