POST /captcha/tasks. عند استدعاء أي واجهة تحقق من الرمز (سلسلة التوكن أو سلسلة التعرف) مع تمرير async: true، ستعيد الواجهة على الفور task_id، وسيتولى الخادم المعالجة على الفور؛ يمكنك استخدام task_id للاستعلام عن النتيجة النهائية، لكن الاستعلام ليس شرطًا لاستمرار تنفيذ المهمة. مناسب لسيناريوهات تبديل المحللين المتعددين (multi-solver rotation): بعد تقديم المهمة، تحصل على task_id على الفور، ثم تقوم بجدولة محللين آخرين، وتعود لاحقًا لقراءة النتائج.
📘 الوثيقة التفاعلية الكاملة (بما في ذلك التصحيح عبر الإنترنت): واجهة استعلام مهام التحقق من الرمز →
عملية التقديم
لاستخدام هذه الواجهة، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية. يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة.الاستخدام الأساسي
الخطوة الأولى: إنشاء مهمة بطريقة غير متزامنة
في جسم الطلب لأي واجهة تحقق من الرمز، قم بتمريرasync: true، ستعيد الواجهة على الفور task_id (HTTP 201)، دون حظر الانتظار:
الخطوة الثانية (اختياري): استعلام النتائج باستخدام task_id
إذا كنت بحاجة إلى عرض التقدم بشكل نشط، يمكنك استخدامtask_id الذي تم إرجاعه في الخطوة السابقة للاستعلام عن POST /captcha/tasks (يوصى بالاستعلام كل 3~5 ثوانٍ). هذه الواجهة لن تؤدي إلى بدء أو دفع معالجة المهمة؛ عند قراءة النتائج الجاهزة، يتم اتباع سلوك التسوية لمرة واحدة الحالي:
status: processing:
status: ready وحقول النتائج المقابلة - هيكل الحقول متطابق تمامًا مع وضع التزامن:
- سلسلة التوكن (hcaptcha، recaptcha2، recaptcha3) تعيد
token:
- تصنيف التعرف (recognition/recaptcha2، recognition/hcaptcha) تعيد
solution؛ recognition/image2text تعيدtext.
/captcha/tasks متاحة لجميع واجهات التحقق من الرمز (سلسلة التوكن وسلسلة التعرف) ويمكن استخدام نفس task_id للاستعلام.
يستمر الخادم في المعالجة منذ الإنشاء، بحد أقصى 120 ثانية. إذا لم يتم الحصول على نتيجة في آخر استعلام قبل الموعد النهائي، سيتم إرجاع HTTP 504. هذه الحالة هي حالة نهائية، يجب على العميل التوقف عن الاستعلام؛ ستعيد الاستعلامات المتكررة لنفس task_id نفس نتيجة الفشل:
status: ready وHTTP 504 حقول التوقيت.
started_at، وقت بدء معالجة المهمة، طابع زمني Unix (ثوانٍ، عائم).finished_at، وقت إنتاج نتيجة المهمة، طابع زمني Unix (ثوانٍ، عائم). لن يتم إرجاع هذا الحقل أثناء المعالجة.elapsed، الوقت المستغرق في معالجة المهمة، وحدة بالثواني (عائم، يحتفظ بـ 3 أرقام عشرية). لن يتم إرجاع هذا الحقل أثناء المعالجة.
توضيح الفوترة
في الوضع غير المتزامن، لا يتم احتساب رسوم لإنشاء المهام وقراءة حالة “قيد المعالجة”؛ يتم احتساب الرسوم مرة واحدة عند قراءة النتيجة الناجحة لأول مرة من قبل العميل (متوافقة مع السلوك الحالي وأسعار وضع التزامن). سيتولى الخادم دفع المهام، لكنه لن يخصم الرسوم مقدمًا بسبب الانتهاء في الخلفية. يتم إنهاء المهام التي لم تنجح خلال 120 ثانية بHTTP 504 ولا يتم احتساب رسوم لها.معالجة الأخطاء
عند استدعاء هذه الواجهة، إذا واجهت خطأ، ستعيد رمز الخطأ والمعلومات المقابلة. على سبيل المثال:400 invalid_request: الطلب يفتقر إلى معلمةtask_id.401 invalid_token: غير مصرح، رمز التفويض غير صالح أو مفقود.404 not_found:task_idغير موجود، أو لا ينتمي إلى الحساب الحالي.504 timeout: تم إنهاء المهمة ولم يتم إنتاج نتيجة؛ يرجى التوقف عن الاستعلام عنtask_idهذا. لن يتم احتساب رسوم لهذا الفشل.

