Pengaturan dan Autentikasi Kunci API CaptchaAI

Setiap permintaan API CaptchaAI memerlukan kunci API. Panduan ini mencakup cara mendapatkan kunci Anda, mengautentikasi permintaan, memeriksa saldo, dan menjaga keamanan kredensial Anda.

Mendapatkan Kunci API Anda

1. Buat akun di captchaai.com
2. Masuk ke dasbor Anda
3. Navigasikan ke Pengaturan API atau Akun
4. Salin kunci API Anda — tampilannya seperti: abc123def456...
5. Tambahkan dana ke saldo Anda (mulai dari $1)

Otentikasi

Setiap panggilan API menyertakan kunci Anda sebagai parameter key:

Kirimkan CAPTCHA

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

Polling untuk Hasil

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

Periksa Saldo

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

Contoh Kode

Python

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"

Keamanan Kunci API

Gunakan Variabel Lingkungan

Jangan pernah melakukan hardcode pada kunci API Anda dalam kode sumber:

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

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

Tetapkan variabel:

# Linux/macOS
export CAPTCHAAI_API_KEY="abc123def456"

# Windows PowerShell
$env:CAPTCHAAI_API_KEY = "abc123def456"

# Windows CMD
set CAPTCHAAI_API_KEY=abc123def456

Gunakan File .env

Untuk pengembangan, gunakan file .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;

Tambahkan .env ke .gitignore Anda untuk mencegah pemberian kredensial:

# .gitignore
.env

Rotasi Kunci Secara Berkala

Jika Anda menduga ada kunci yang disusupi:

1. Masuk ke dasbor CaptchaAI Anda
2. Hasilkan kunci API baru
3. Perbarui variabel lingkungan Anda
4. Cabut kunci lama

Respons Kesalahan

Pertanyaan Umum

Apakah saya memerlukan kunci yang berbeda untuk setiap jenis CAPTCHA?

Tidak. Satu kunci API berfungsi untuk semua jenis CAPTCHA dan semua titik akhir API.

Apakah ada batasan tarif pada panggilan API?

CaptchaAI memungkinkan tingkat permintaan yang tinggi. Untuk volume yang sangat tinggi (100K+/day), hubungi dukungan untuk kapasitas khusus.

Bisakah saya menggunakan kunci yang sama di beberapa proyek?

Ya. Satu kunci berfungsi di semua proyek dan server Anda. Untuk penagihan terpisah, buat akun tambahan.

Panduan Terkait

• Panduan Memulai CaptchaAI
• Format Respons API
• Panggilan Balik vs Polling