التوثيق
كل ما تحتاجه لإرسال أول عملية حل والحفاظ على قبولها.
أول عملية حل في أربع خطوات
- 01أنشئ حسابًا
أنشئ حسابًا وأكّد بريدك الإلكتروني. تحصل الحسابات الجديدة على 0.10 US$ رصيدًا مجانيًا، دون الحاجة إلى بطاقة.
- 02أنشئ مفتاح API
من لوحة التحكم ضمن قسم المفاتيح. تبدأ المفاتيح بـ cn- وتُعرض مرة واحدة، لذا احفظ مفتاحك في مكان آمن.
- 03أرسل طلب حل
أرسل بطلب POST النوع وsitekey وعنوان URL للصفحة إلى /v1/solve?wait=60 مع Authorization: Bearer cn-…
- 04أرسل الرمز token
ضع الرمز token حيث تتوقعه الصفحة وأرسل خلال دقيقتين تقريبًا.
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 }اختر التكامل المناسب لك
أمثلة عملية على الـ API الحقيقية، مع المزالق الخاصة بكل أداة.
احرص على قبول رموز token
معظم الرموز الصالحة التي تُرفض يعود سبب رفضها إلى أحد هذه الأمور.
الرمز token المُنشأ على عنوان IP أو متصفح مختلف عن الذي يرسله هو السبب الأكثر شيوعًا للرفض.
في reCAPTCHA v3، أرسل اسم الإجراء نفسه الذي تستخدمه الصفحة. عدم التطابق يخفض النقاط بصمت.
تنتهي صلاحية الرموز token خلال دقيقتين تقريبًا وهي صالحة للاستخدام مرة واحدة. اطلب الحل قبل الإرسال مباشرة، ومن جديد في كل إعادة محاولة.
الانتظار المتزامن أم الاستطلاع الدوري
مع ?wait=N (حتى 120 ثانية) يبقى طلب الحل معلقًا حتى تجهز النتيجة. وبدونه تحصل على id للمهمة فورًا وتستطلع GET /v1/task/{id} كل خمس ثوانٍ. يبقى الحل المدفوع قابلًا للاسترجاع لمدة عشر دقائق، لذا فإن انقطاع الاتصال لا يُفقدك عملية الحل.
الفوترة
لا تُحتسب الرسوم إلا عند نجاح عملية الحل؛ وعمليات الحل الفاشلة مجانية. تتضمن كل استجابة تكلفتها cost، وتُعيد GET /v1/balance رصيدك المتبقي. الأسعار لكل نوع موجودة في صفحة الأسعار.
المفاتيح والفرق
يمكن أن يحتوي الحساب على ما يصل إلى عشرة مفاتيح نشطة. سمّها حسب المشروع أو العميل، وستعرض لوحة التحكم الاستخدام لكل مفتاح؛ وإلغاء أحدها لا يؤثر في البقية.
الأسئلة الشائعة حول التوثيق
هل توجد SDK رسمية؟
نعم. تتوفر حزم SDK مفتوحة المصدر لـ Python وNode.js وTypeScript وGo وPHP على GitHub. لكنك لا تحتاج إلى أي منها: CaptchaNo واجهة REST API بسيطة تستقبل JSON وتُرجعه، لذا يعمل معها أي عميل HTTP، وتعرض أدلة التكامل الأسطر القليلة اللازمة لكل لغة وأداة.
ما أنواع التحديات المدعومة؟
reCAPTCHA v2 (مربع الاختيار وغير المرئية)، وreCAPTCHA v3، وأدوات reCAPTCHA Enterprise بنمط مربع الاختيار، وCloudflare Turnstile، وDataDome، وكابتشا الصور أو النصوص، وكلها بشكل الطلب نفسه.
هل أحتاج إلى بروكسي؟
في DataDome، نعم، لأن ملف cookie مرتبط بعنوان IP الذي حصل عليه. أما في تحديات الرموز token فهو اختياري لكنه يحسّن القبول، لأن الموقع يستطيع مقارنة مكان إنتاج الرمز بمكان إرساله.
ماذا يحدث عند فشل عملية الحل؟
تنتهي المهمة بالحالة failed مع رمز خطأ، ولا تُحتسب عليك رسوم. أعد المحاولة بطلب جديد.
أين يمكنني رؤية استخدامي؟
تعرض لوحة التحكم كل عمليات الحل مع نوعها ومدتها وتكلفتها والمفتاح المستخدم، كما تعرض رصيدك والإنفاق لكل مفتاح.
أدلة مفيدة
هل أنت مستعد للبناء؟
ابدأ بفترة تجريبية مجانية لمدة 3 أيام، ثم ادفع مقابل كل عملية حل ناجحة مع نمو حركة المرور لديك. لا حاجة إلى بطاقة للفترة التجريبية.