[ التكامل ]

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

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

cURL · Shell

curl -X POST "https://api.captchano.com/v1/solve?wait=60" \
  -H "Authorization: Bearer cn-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "type": "recaptcha_v2",
        "sitekey": "6LcABC...",
        "url": "https://example.com/login",
        "proxy": "http://user:pass@host:port"
      }'

# 200 OK
# { "id": "slv_…", "status": "ready",
#   "solution": { "token": "03AGdBq25S…" },
#   "cost": "0.00598", "solveTime": 18.4 }

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

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

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

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

التكلفة

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

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

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

الـ API مبنية على HTTPS وJSON فقط، لذا فإن cURL هي أسرع طريقة لرؤية عملية حل كاملة من البداية إلى النهاية قبل كتابة أي شيفرة.

01
أنشئ مفتاحًا
أنشئ مفتاح API من لوحة التحكم. يبدأ المفتاح بـ cn-.
02
أرسل طلب حل
أرسل بطلب POST كائن JSON يحتوي على type وsitekey وurl إلى /v1/solve?wait=60 مع الترويسة Authorization: Bearer.
03
اقرأ الاستجابة
تعود الحقول status وsolution.token وcost وsolveTime في كائن JSON واحد.
04
استطلع إن كنت تفضّل ذلك
احذف ?wait واستطلع GET /v1/task/{id} كل بضع ثوانٍ بدلًا من ذلك.

إدراج الرمز token في الصفحة

تنسخ الرمز token من استجابة JSON إلى حقل النموذج أو إلى الطلب الذي يرسله عميلك.

[ المزالق ]

أين تخطئ عمليات التكامل عادةً

نوع المحتوى مفقود

أرسل Content-Type: application/json، وإلا فلن يُحلَّل جسم الطلب.

علامات الاقتباس في الصدفة (shell)

ضع JSON بين علامتي اقتباس مفردتين كي لا توسّع الصدفة أي شيء بداخله.

[ الأسئلة الشائعة ]

الأسئلة الشائعة حول الكابتشا في ⁦cURL⁩

هل أحتاج إلى SDK؟

لا. CaptchaNo هي REST API بسيطة. أي عميل HTTP بأي لغة يعمل، وcURL هي أسهل طريقة لتجربتها.

كيف أتحقق من رصيدي؟

استدعِ GET /v1/balance مع ترويسة Authorization نفسها. تعرض لوحة التحكم أيضًا الرصيد والاستخدام وكل عمليات الحل.

ماذا تُعيد عملية الحل الفاشلة؟

الحالة failed مع رمز خطأ. لا تُحتسب رسوم على عمليات الحل الفاشلة، لذا يمكنك إعادة المحاولة بأمان.

كم يمكنني الانتظار للحصول على النتيجة؟

يُبقي المعامل wait الطلب معلقًا حتى 120 ثانية. تعود معظم عمليات الحل قبل ذلك بكثير؛ استخدم الاستطلاع الدوري إذا كان عميلك لا يستطيع إبقاء الاتصال مفتوحًا كل هذه المدة.

[ اقرأ أيضًا ]