الانتقال إلى المحتوى الرئيسي
ستقدم هذه الوثيقة شرحًا لواجهة برمجة التطبيقات للتعرف على رموز التحقق الرقمية باللغة الإنجليزية، والتي تعتمد على تقنية التعلم العميق، ويمكن استخدامها للتعرف على رموز التحقق الرقمية باللغة الإنجليزية ذات الطول المتغير. يتم إدخال محتوى صورة رمز التحقق، ويتم إخراج نتيجة رمز التحقق.

​
عملية التقديم

لاستخدام واجهة برمجة التطبيقات، يجب أولاً زيارة صفحة واجهة برمجة التطبيقات للتعرف على رموز التحقق الرقمية باللغة الإنجليزية للتقدم للحصول على الخدمة المناسبة، بعد الدخول إلى الصفحة، انقر على زر “Acquire”، كما هو موضح في الصورة: إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد تسجيل الدخول والتسجيل، سيتم العودة تلقائيًا إلى الصفحة الحالية. عند التقديم لأول مرة، سيكون هناك حد مجاني متاح، يمكنك استخدام واجهة برمجة التطبيقات مجانًا.

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

أولاً، يجب أن نفهم طريقة الاستخدام الأساسية، وهي إدخال صورة رمز التحقق الرقمية باللغة الإنجليزية ذات الطول المتغير، للحصول على النتيجة المعالجة، يجب أولاً تمرير حقل image، وهو صورة رمز التحقق الرقمية باللغة الإنجليزية المحددة، كما هو موضح في الصورة:

ثم نحتاج إلى تحويل صورة رمز التحقق إلى ترميز Base64، يُوصى باستخدام ملحق متصفح جوجل كروم FeHelper لإجراء التحويل، يمكن الرجوع إلى الصورة أدناه لطريقة الاستخدام المحددة:

بعد ذلك، يمكنك نسخ ترميز Base64 الذي تم الحصول عليه من ملحق متصفح جوجل كروم FeHelp، تذكر أنه لا يحتوي على البادئة data:image/png;base64، المحتوى المحدد كما يلي:

يمكنك أن ترى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:
  • accept: نوع الاستجابة التي ترغب في تلقيها، هنا يتم ملؤها بـ application/json، أي بتنسيق JSON.
  • authorization: مفتاح واجهة برمجة التطبيقات، بعد التقديم يمكنك اختياره مباشرة من القائمة المنسدلة.
بالإضافة إلى ذلك، تم تعيين جسم الطلب، بما في ذلك:
  • image: صورة رمز التحقق المشفرة بتنسيق Base64 (بدون بادئة data:image/png;base64).
بعد الاختيار، يمكنك أن تلاحظ أنه تم إنشاء الكود المقابل على الجانب الأيمن، كما هو موضح في الصورة:

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، هنا حصلنا على النتيجة التالية: 
{
  "text": "7364"
}
تتضمن النتيجة العائدة عدة حقول، كما هو موضح أدناه:
  • text: محتوى النص الناتج عن معالجة صورة رمز التحقق الرقمية باللغة الإنجليزية ذات الطول المتغير.
يمكنك أن ترى أننا حصلنا على نتيجة التحقق من معالجة صورة رمز التحقق الرقمية باللغة الإنجليزية ذات الطول المتغير، كل ما علينا هو استخدام محتوى النص في text للمرور بالتحقق. بالإضافة إلى ذلك، إذا كنت ترغب في توليد الكود المقابل للتكامل، يمكنك نسخه مباشرة، على سبيل المثال، كود CURL كما يلي: 
curl -X POST 'https://api.acedata.cloud/captcha/recognition/image2text' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX..."
}'
كود التكامل بلغة Python كما يلي: 
import requests

url = "https://api.acedata.cloud/captcha/recognition/image2text"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX..."
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

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

عند استدعاء واجهة برمجة التطبيقات، إذا واجهت خطأ، ستقوم واجهة برمجة التطبيقات بإرجاع رمز الخطأ والمعلومات ذات الصلة. على سبيل المثال:
  • 400 token_mismatched: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 400 api_not_implemented: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 401 invalid_token: غير مصرح به، رمز التفويض غير صالح أو مفقود.
  • 429 too_many_requests: عدد كبير جدًا من الطلبات، لقد تجاوزت الحد الأقصى لمعدل الطلبات.
  • 500 api_error: خطأ في الخادم الداخلي، حدث خطأ ما على الخادم.

​
مثال على استجابة الخطأ

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
الخاتمة

من خلال هذه الوثيقة، أصبحت على دراية بكيفية استخدام واجهة برمجة التطبيقات للتعرف على رموز التحقق الرقمية باللغة الإنجليزية التي يمكن استخدامها للتعرف على رموز التحقق الرقمية باللغة الإنجليزية ذات الطول المتغير. يتم إدخال محتوى صورة رمز التحقق، ويتم إخراج نتيجة رمز التحقق. نأمل أن تساعدك هذه الوثيقة في تكامل واستخدام واجهة برمجة التطبيقات بشكل أفضل. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.