[ التكامل ]

أداة حل الكابتشا لـ
n8n

حلّ التحدي داخل التشغيل بدلًا من إفشال المهمة. مثال عملي بلغة ⁦JSON⁩، والعوامل الثلاثة التي تحدد قبول الرمز token.

n8n · JSON

HTTP Request node
  Method:          POST
  URL:             https://api.captchano.com/v1/solve?wait=60
  Authentication:  Header Auth
                   Name:  Authorization
                   Value: Bearer cn-YOUR_API_KEY
  Send Body:       JSON
  Body:
  {
    "type": "turnstile",
    "sitekey": "{{ $json.sitekey }}",
    "url": "{{ $json.pageUrl }}"
  }

The node outputs { status, solution: { token, userAgent }, cost } —
pass {{ $json.solution.token }} to the next step.

ما الذي يحدد قبول الرمز token

مرّر البروكسي الخاص بك. يجب أن يُنشأ الرمز token خلف عنوان IP الخروج نفسه الذي يرسله. وفي الأنظمة التي تقيّم الجلسة، يكون هذا إلزاميًا، وليس مجرد تحسين.
طابِق وكيل المستخدم. يربط Turnstile وعدة أنظمة حماية من الروبوتات الرمز token بوكيل مستخدم. نُعيد لك الوكيل المستخدَم كي تعيد استخدامه كما هو تمامًا.
اطلب متأخرًا. تنتهي صلاحية الرموز token خلال 120 ثانية تقريبًا. اطلب رمزًا عندما تكون مستعدًا للإرسال.

الانتظار المتزامن أم الاستطلاع الدوري

يستخدم المثال ?wait=60، فيُعيد الاستدعاء عملية الحل مكتملة وتبقى خطوة ⁦n8n⁩ لديك خطية. وإن كنت تفضّل عدم إبقاء الاتصال مفتوحًا، فاحذف المعامل، واحتفظ بالمعرّف id المُعاد، واستطلع GET /v1/task/{id} كل خمس ثوانٍ. يبقى الرمز token الذي دفعت ثمنه قابلًا للاسترجاع لمدة عشر دقائق، لذا فإن انقطاع الاتصال لا يُفقدك عملية الحل.

التكلفة

⁦$0.00598⁩ لكل عملية حل ناجحة لـ reCAPTCHA v2، ولا تُحتسب عمليات الحل الفاشلة أبدًا. راجع الأسعار لكل أنواع التحديات، أو مرجع API للاطلاع على شكل الطلب الكامل.

[ موقعه في سير العمل ]

كيف تندمج عملية الحل في ⁦n8n⁩

في n8n، تكون عملية الحل عقدة HTTP Request واحدة بين الخطوة التي تحمّل الصفحة والخطوة التي ترسلها.

01
أضف بيانات الاعتماد
أنشئ بيانات اعتماد من نوع Header Auth بالقيمة Authorization: Bearer cn-…
02
أضف عقدة HTTP Request
أرسل بطلب POST إلى API مع ?wait=60 وجسم JSON مبني من العقد السابقة.
03
اربط الرمز token
استخدم تعبيرًا (expression) لتمرير solution.token إلى العقدة التالية.
04
تعامل مع حالات الفشل
أنشئ تفرعًا بحسب status كي تؤدي عملية الحل الفاشلة إلى إعادة المحاولة أو إطلاق تنبيه بدلًا من إرسال لا شيء.