إعداد مفتاح CaptchaAI API والمصادقة

كل طلب إلى CaptchaAI API يحتاج مفتاح API. هذا الدليل يشرح كيف تحصل على مفتاحك، وكيف تُرفقه مع الطلبات، وكيف تتحقق من رصيدك، وكيف تحافظ على أمان بيانات الاعتماد.

الحصول على مفتاح الـ API

1. أنشئ حساباً على captchaai.com
2. سجّل الدخول إلى لوحة التحكم
3. انتقل إلى إعدادات API أو الحساب
4. انسخ مفتاح الـ API — يبدو كما يلي: abc123def456...
5. أضف رصيداً إلى حسابك (تبدأ من 1 دولار)

المصادقة

يتضمن كل استدعاء لواجهة برمجة التطبيقات مفتاحك كمعلمة key:

إرسال اختبار CAPTCHA

GET https://ocr.captchaai.com/in.php?key=YOUR_API_KEY&method=userrecaptcha&googlekey=SITE_KEY&pageurl=URL

استطلاع للنتائج

GET https://ocr.captchaai.com/res.php?key=YOUR_API_KEY&action=get&id=TASK_ID

التحقق من الرصيد

GET https://ocr.captchaai.com/res.php?key=YOUR_API_KEY&action=getbalance

أمثلة على الكود

بايثون

import requests
import os

# Load from environment variable (recommended)
API_KEY = os.environ.get("CAPTCHAAI_API_KEY")

# Check balance
balance = requests.get("https://ocr.captchaai.com/res.php", params={
    "key": API_KEY,
    "action": "getbalance"
})
print(f"Balance: ${balance.text}")

# Submit a CAPTCHA
resp = requests.get("https://ocr.captchaai.com/in.php", params={
    "key": API_KEY,
    "method": "userrecaptcha",
    "googlekey": "6Le-wvkS...",
    "pageurl": "https://example.com"
})
print(f"Response: {resp.text}")

Node.js

const axios = require("axios");

const API_KEY = process.env.CAPTCHAAI_API_KEY;

// Check balance
const balance = await axios.get("https://ocr.captchaai.com/res.php", {
  params: { key: API_KEY, action: "getbalance" },
});
console.log(`Balance: $${balance.data}`);

// Submit a CAPTCHA
const resp = await axios.get("https://ocr.captchaai.com/in.php", {
  params: {
    key: API_KEY,
    method: "userrecaptcha",
    googlekey: "6Le-wvkS...",
    pageurl: "https://example.com",
  },
});
console.log(`Response: ${resp.data}`);

cURL

# Check balance
curl "https://ocr.captchaai.com/res.php?key=YOUR_API_KEY&action=getbalance"

# Submit reCAPTCHA v2
curl "https://ocr.captchaai.com/in.php?key=YOUR_API_KEY&method=userrecaptcha&googlekey=SITE_KEY&pageurl=https://example.com"

أمان مفتاح الـ API

استخدام متغيرات البيئة

لا تضع مفتاح الـ API مباشرةً في الكود المصدري:

# ❌ Bad — key in source code
API_KEY = "abc123def456"

# ✅ Good — key from environment
API_KEY = os.environ["CAPTCHAAI_API_KEY"]

تعيين المتغير:

# Linux/macOS
export CAPTCHAAI_API_KEY="abc123def456"

# Windows PowerShell
$env:CAPTCHAAI_API_KEY = "abc123def456"

# Windows CMD
set CAPTCHAAI_API_KEY=abc123def456

استخدام ملفات .env

للتطوير المحلي، استخدم ملف .env:

# .env
CAPTCHAAI_API_KEY=abc123def456

# Python
from dotenv import load_dotenv
load_dotenv()
API_KEY = os.environ["CAPTCHAAI_API_KEY"]

// Node.js
require("dotenv").config();
const API_KEY = process.env.CAPTCHAAI_API_KEY;

أضف .env إلى .gitignore لمنع رفعها إلى مستودع الكود:

# .gitignore
.env

تدوير المفاتيح بانتظام

إذا اشتبهت في تسرّب مفتاح ما:

1. سجّل الدخول إلى لوحة التحكم على captchaai.com
2. أنشئ مفتاح API جديداً
3. حدّث متغيرات البيئة في خوادمك
4. ألغِ المفتاح القديم

ردود الأخطاء

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

هل أحتاج مفتاحاً مختلفاً لكل نوع CAPTCHA؟

لا. مفتاح API واحد يعمل مع جميع أنواع CAPTCHA وجميع نقاط نهاية الـ API.

هل توجد حدود لمعدل الطلبات؟

يدعم CaptchaAI معدلات طلب مرتفعة. للأحجام الكبيرة جداً (أكثر من 100 ألف/يوم)، تواصل مع الدعم للحصول على سعة مخصصة.

هل يمكنني استخدام نفس المفتاح عبر مشاريع متعددة؟

نعم. مفتاح واحد يعمل عبر جميع مشاريعك وخوادمك. إذا أردت فواتير منفصلة، أنشئ حسابات إضافية.

أدلة ذات صلة

• دليل البدء السريع مع CaptchaAI
• تنسيقات استجابة الـ API
• الاستطلاع الدوري مقابل رد النداء