واجهة برمجة التطبيقات للتعرف على رموز التحقق الرقمية باللغة الإنجليزية

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

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

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

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

📘 الوثائق الكاملة: واجهة برمجة التطبيقات للتعرف على رموز التحقق الرقمية باللغة الإنجليزية →

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

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

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

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

يمكنك أن ترى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:

accept: نوع التنسيق الذي ترغب في تلقيه كاستجابة، هنا يتم ملؤه بـ application/json، أي بتنسيق JSON.
authorization: مفتاح استدعاء واجهة برمجة التطبيقات، يمكنك اختياره مباشرة بعد التقديم.

بالإضافة إلى ذلك، تم تعيين جسم الطلب، بما في ذلك:

image: صورة رمز التحقق المشفرة بتنسيق Base64 (بدون بادئة data:image/png;base64).

بعد الاختيار، يمكنك أن تلاحظ أنه تم إنشاء الكود المقابل على الجانب الأيمن، كما هو موضح في الصورة:

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، هنا حصلنا على النتيجة التالية:

{
  "text": "7364",
  "elapsed": 31.6
}

تتضمن النتيجة العائدة عدة حقول، كما يلي:

text: محتوى النص الناتج عن معالجة صورة رمز التحقق الرقمية ذات الطول المتغير.
started_at، finished_at: الوقت الذي بدأ فيه الطلب معالجة وإنتاج النتيجة، طابع زمني Unix (ثوانٍ، نقطة عائمة).
elapsed: إجمالي الوقت المستغرق في المعالجة (ثوانٍ).

يمكنك أن ترى أننا حصلنا على نتيجة التحقق من معالجة صورة رمز التحقق الرقمية ذات الطول المتغير، كل ما علينا هو استخدام محتوى النص في 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)

الوضع غير المتزامن (async)

بشكل افتراضي، تكون واجهة برمجة التطبيقات متزامنة وتنتظر: ستظل الطلبات تنتظر حتى تكتمل معالجة نتيجة التعرف. إذا كنت تقوم بتدوير عدة حلّات (multi-solver rotation) وترغب في “تقديم المهمة والحصول على task_id على الفور، ثم الانتقال إلى جدولة حلّات أخرى، والعودة لاحقًا لقراءة النتائج”، يمكنك تمرير async: true في جسم الطلب. بعد تمرير async: true، ستعيد الواجهة على الفور task_id، دون الانتظار:

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...",
  "async": true
}'

{
  "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002",
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

إذا كنت ترغب في التحقق من التقدم بشكل نشط، يمكنك استخدام task_id للاستعلام عن POST /captcha/tasks (يوصى بذلك كل 3~5 ثوانٍ). لن تؤدي هذه الواجهة إلى بدء أو دفع معالجة المهمة؛ حتى لو لم يتم الاستعلام، أو انقطع الاتصال، أو خرجت من العميل، سيستمر الخادم في المعالجة:

curl -X POST 'https://api.acedata.cloud/captcha/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002"
}'

أثناء المعالجة، ستعيد status: processing:

{ "success": true, "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002", "status": "processing" }

عند الانتهاء من المعالجة، ستعيد status: ready ونتيجة التعرف text (هيكل الحقول متطابق تمامًا مع الوضع المتزامن):

{
  "success": true,
  "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002",
  "status": "ready",
  "text": "7364"
}

شرح الفوترة: في الوضع غير المتزامن، لا يتم احتساب رسوم لإنشاء المهمة أو قراءة حالة “قيد المعالجة”؛ يتم احتساب الرسوم مرة واحدة عند قراءة النتيجة الناجحة من العميل لأول مرة (بما يتماشى مع السلوك الحالي وسعر الوضع المتزامن). سيقوم الخادم بدفع المهمة بشكل مستقل، لكنه لن يخصم الرسوم مقدمًا لمجرد أن الخلفية قد اكتملت أولاً. ستنتهي المهمة في حالة عدم النجاح خلال 120 ثانية إلى HTTP 504 timeout، دون احتساب رسوم. /captcha/tasks لا تتحمل مسؤولية دفع المهمة.

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

عند استدعاء واجهة برمجة التطبيقات، إذا واجهت خطأ، ستعيد الواجهة رمز الخطأ والمعلومات ذات الصلة. على سبيل المثال:

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"
}

الاستنتاج

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

البداية

دردشة الذكاء الاصطناعي

صورة الذكاء الاصطناعي

فيديو الذكاء الاصطناعي

الصوت الذكي

الويب والبيانات

CAPTCHA

الهوية

وكيل

متقدم

Coding

واجهة برمجة التطبيقات للتعرف على رموز التحقق الرقمية باللغة الإنجليزية

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

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

الوضع غير المتزامن (async)

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

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

الاستنتاج

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

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

​الوضع غير المتزامن (async)

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

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

​الاستنتاج

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

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

الوضع غير المتزامن (async)

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

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

الاستنتاج