Skip to main content
ستقدم هذه المقالة شرحًا حول واجهة برمجة التطبيقات للتعرف على بروتوكول Recaptcha3، والتي تتيح للمستخدمين التحقق من صحة Recaptcha3 دون الحاجة إلى التعرف على الصور أو النقر عليها، بل من خلال تقديم مفتاح الموقع فقط لتحقيق فك التشفير التلقائي في الخلفية وإكمال التحقق.

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

لاستخدام واجهة برمجة التطبيقات للتعرف على بروتوكول Recaptcha3، يجب أولاً الذهاب إلى لوحة تحكم Ace Data Cloud للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية. إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية. يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. ستتلقى رصيدًا مجانيًا عند التقديم لأول مرة، يمكنك تجربته مجانًا؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في لوحة التحكم.
📘 الوثائق الكاملة: واجهة برمجة التطبيقات للتعرف على بروتوكول Recaptcha3 →

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

أولاً، يجب أن نفهم طريقة الاستخدام الأساسية، مقارنةً بـ Recaptcha2، نحتاج إلى تمرير معلمة إضافية page_action، والتي يجب الحصول عليها من الكود، عنوان URL لعرض سرعة الشبكة هو: https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php، وفيما يلي طريقة للحصول عليها:

​
طريقة سريعة:

افتح f12، ثم ابحث في صفحة العناصر عن .execute(، في منطقة الإطار الأحمر يمكننا رؤية معلمة action، بينما تتبعها سلسلة من الأحرف، وهذه أيضًا هي المحتويات المطلوبة في النص أدناه، كما هو موضح في الصورة أدناه.

بعد ذلك، تحتاج أيضًا إلى إدخال عنوان URL للموقع الذي يحتاج إلى معالجة CAPTCHA، للحصول على النتيجة المعالجة، يجب أولاً تمرير حقل website_url ببساطة، وأخيرًا تحتاج إلى إدخال معلمة website_key، والتي يمكن الحصول عليها من النص أعلاه، وهي أيضًا سلسلة من الأحرف بعد execute. يمكننا بعد ذلك ملء المحتويات المقابلة في الواجهة، كما هو موضح في الصورة أدناه:

يمكننا أن نرى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:
  • accept: نوع الاستجابة التي ترغب في تلقيها، هنا يتم ملؤها بـ application/json، أي بتنسيق JSON.
  • authorization: مفتاح استدعاء واجهة برمجة التطبيقات، يمكن اختياره مباشرة بعد التقديم.
بالإضافة إلى ذلك، تم تعيين جسم الطلب، بما في ذلك:
  • page_action: يجب الحصول عليها من كود الموقع الذي يحتوي على CAPTCHA.
  • website_url: عنوان URL للموقع الذي يحتاج إلى معالجة CAPTCHA.
  • website_key: معرف مفتاح الموقع في Recaptcha3.
بعد الاختيار، يمكن ملاحظة أنه تم إنشاء كود مطابق على الجانب الأيمن، كما هو موضح في الصورة أدناه:

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، وهنا حصلنا على النتيجة التالية:
تحتوي النتيجة على عدة حقول، كما هو موضح أدناه:
  • token، نتيجة التحقق من مهمة Recaptcha3.
  • started_at، finished_at: وقت بدء معالجة الطلب وإنتاج النتيجة، طابع زمني Unix (ثوانٍ، عائم).
  • elapsed: إجمالي الوقت المستغرق في المعالجة (ثوانٍ).
يمكننا أن نرى أننا حصلنا على نتيجة معالجة Recaptcha3، ثم يمكننا استخدامها في POST أو GET لمحاكاة الإرسال إلى الموقع المستهدف، للاستخدام مرة واحدة، صلاحيتها 120 ثانية، يُنصح باستخدامها خلال 60 ثانية. فيما يلي سنقدم بإيجاز طريقة لتقديم الـ token الناتج إلى الموقع المستهدف: استدعاء كود Python للتحقق من الـ token:
لذا يمكننا الحصول على النتيجة:
可以看到，其中 success 表示此处验证的处理结果，所有我们成功通过Recaptcha3验证码的验证。 另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：
Python 的对接代码如下：

​
异步模式（async）

默认情况下 API 是同步阻塞的：一次请求会一直等待，直到 token 处理完成才返回。如果你在做多打码器轮换（multi-solver rotation），希望「提交任务后立即拿到 task_id，先去调度其他打码器，稍后再回来读取结果」，可以在请求体中传入 async: true。 传入 async: true 后，接口会立即返回一个 task_id，而不会阻塞等待：
如需主动查看进度，可使用该 task_id 查询 POST /captcha/tasks（建议每 3~5 秒一次）。本接口不会触发或推进任务处理；即使不查询、断网或退出客户端，服务器仍会继续处理：
处理中会返回 status: processing：
处理完成会返回 status: ready 和 token：
计费说明：异步模式下，创建任务和读取「处理中」状态都不计费；客户端首次读取成功结果时计费一次（与现有行为及同步模式价格一致）。服务器会自主推进任务，但不会因为后台先完成就提前扣费。任务在 120 秒内未成功会终止为 HTTP 504 timeout，不计费。/captcha/tasks 不负责推进任务。

​
错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：
  • 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token：Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests：Too many requests, you have exceeded the rate limit.
  • 500 api_error：Internal server error, something went wrong on the server.

​
错误响应示例

​
结论

通过本文档，您已经了解了如何使用 Recaptcha3 协议识别 API 让用户无需识别和点选 Recaptcha3 验证码图片，仅需通过提交 Website Key 即可实现后台自动解码，完成验证。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。