Dökümantasyon

CaptchaERPIDE API Kılavuzu

12 captcha endpoint, kod örnekleri, hata kodları ve rate limit bilgileri.

Genel Bakış

CaptchaERPIDE bir REST API'dir. Görsel captcha tipleri (slider, jigsaw, rotate, text, icon, math, odd-one-out) kendi OpenCV+AI tabanlı çözücülerimizle çalışır. Token-tabanlı captcha'lar (hCaptcha, Cloudflare Turnstile, Geetest) sunucumuzda çalışan stealth headless Firefox (Camoufox) ile çözülür — 3rd-party servise (2Captcha, CapMonster) bağımlı değiliz.

Base URLhttps://captcha.erpide.com
AuthAuthorization: Bearer cap_xxxxxxxxxxxxx
Content-Typeapplication/json (token) | multipart/form-data (image)
API Key nasıl alınır?Üye ol → ürün satın al veya 3 gün ücretsiz dene → Hesabım → Lisanslarım

Kimlik Doğrulama

Tüm istekler Authorization header'ı taşımalıdır:

Authorization: Bearer cap_d93e62df13a04e399bd1af1c5832d77fce1b450675951ded

⚠️ API anahtarını git repo, frontend kodu veya log'lara yazma. Yeni anahtar üretmek için Hesabım → Lisanslarım sayfasından "Detaylı Panel" linkine git.

Token Captcha'lar (Yeni)

Bu üç captcha tipi browser fingerprint üzerine kuruludur — gerçek bir tarayıcı widget'ı yüklemeden token üretilmez. Bizim sunucumuzda stealth Camoufox çalışıyor, çıkan token'ı sana iletiyor. İstemcin sadece bu token'ı kendi formuna yapıştırır.

POST/api/v1/solve-turnstileCloudflare Turnstile

Cloudflare'in görünmez/görünür challenge'ı. Ortalama 8-15 saniyede tamamlanır.

İstek (JSON)

{
  "sitekey": "0x4AAAAAAA...",
  "page_url": "https://example.com/protected",
  "action": null,
  "cdata": null
}

Cevap (200 OK)

{
  "success": true,
  "token": "0.AbCdEf...g==.XXXXX",
  "user_agent": "Mozilla/5.0 (...) Firefox/135.0",
  "captcha_type": "turnstile",
  "solve_time_ms": 12700
}
POST/api/v1/solve-hcaptchahCaptcha

Image grid veya audio challenge. Audio mode'da Whisper ile transcribe edilir.

İstek (JSON)

{
  "sitekey": "10000000-ffff-ffff-ffff-000000000001",
  "page_url": "https://example.com/login",
  "is_invisible": false
}

Cevap (200 OK)

{
  "success": true,
  "token": "P0_eyJ0eXAiOiJKV1QiLCJhbGciOi...",
  "user_agent": "Mozilla/5.0 (...)",
  "captcha_type": "hcaptcha",
  "solve_time_ms": 18430
}
POST/api/v1/solve-geetestGeetest v3 / v4

Slider (v3) veya icon grid (v4). version=3 için 'challenge' zorunlu.

İstek (JSON)

{
  "gt": "ababababababababababab",
  "challenge": "cdcdcdcdcdcdcdcdcdcdcd",
  "page_url": "https://example.com/captcha",
  "version": 3,
  "api_server": "api.geetest.com"
}

Cevap (200 OK)

{
  "success": true,
  "token": "abcdef1234567890",
  "captcha_type": "geetest_v3",
  "solve_time_ms": 14200
}

Görsel Captcha'lar

Bu endpoint'ler multipart/form-data kabul eder. Görseli upload edersin, AI çözücümüz ~30ms içinde sonucu döner.

POST/api/v1/solveSlider Captcha

Parça (piece) görselini arka plan (bg) üzerine kaydırma X koordinatı.

Form-data alanları

  • bg_imageArka plan PNG/JPG
  • piece_imageSlider parçası
  • piece_yParçanın Y konumu (varsayılan 0)
  • piece_wParça genişliği (varsayılan 70)
  • piece_hParça yüksekliği (varsayılan 70)

Cevap (200 OK)

{
  "success": true,
  "x": 187,
  "solve_time_ms": 28.4,
  "captcha_type": "slider"
}
POST/api/v1/solve-urlSlider (URL ile)

Görsel upload yerine URL gönder, sunucu indirsin.

İstek (JSON)

{
  "bg_url": "https://example.com/captcha/bg.png",
  "piece_url": "https://example.com/captcha/piece.png",
  "piece_y": 0,
  "piece_w": 70,
  "piece_h": 70
}

Cevap (200 OK)

{
  "success": true,
  "x": 187,
  "solve_time_ms": 142.7,
  "captcha_type": "slider"
}
POST/api/v1/solve-rotateRotate Puzzle

İç görseli doğru açıya çevir — derece olarak döner.

Form-data alanları

  • outer_imageDış (sabit) görsel
  • inner_imageDöndürülecek iç görsel
  • stepDerece adımı (varsayılan 5)

Cevap (200 OK)

{
  "success": true,
  "angle": 145,
  "solve_time_ms": 84.1,
  "captcha_type": "rotate"
}
POST/api/v1/solve-jigsawJigsaw Puzzle

Parça konumunu 2D olarak bul.

Form-data alanları

  • bg_imageArka plan
  • piece_imageParça

Cevap (200 OK)

{
  "success": true,
  "x": 220,
  "y": 88,
  "solve_time_ms": 56,
  "captcha_type": "jigsaw"
}
POST/api/v1/solve-textText / Number Captcha

OCR ile metin oku. charset: alphanumeric | digits | letters

Form-data alanları

  • imageCaptcha görseli
  • charsetKarakter seti (varsayılan alphanumeric)

Cevap (200 OK)

{
  "success": true,
  "text": "abcd123",
  "solve_time_ms": 91.3,
  "captcha_type": "text"
}
POST/api/v1/solve-mathMath Captcha

'3+7=?' tipi soruyu oku ve cevapla.

Form-data alanları

  • imageSoru görseli

Cevap (200 OK)

{
  "success": true,
  "text": "10",
  "solve_time_ms": 110.5,
  "captcha_type": "math"
}
POST/api/v1/solve-iconIcon Click — Tek Hedef

Görsel içinde belirtilen hedefi bul, koordinatını döndür.

Form-data alanları

  • imageAna görsel
  • targetHedef görsel
  • thresholdEşleşme eşiği (varsayılan 0.6)

Cevap (200 OK)

{
  "success": true,
  "x": 156,
  "y": 73,
  "solve_time_ms": 65.4,
  "captcha_type": "icon"
}
POST/api/v1/solve-icon-allIcon Click — Hepsi

'Tüm arabaları seç' tipi — eşleşen tüm pozisyonları döner.

Form-data alanları

  • imageAna görsel
  • targetHedef görsel
  • thresholdEşleşme eşiği

Cevap (200 OK)

{
  "success": true,
  "positions": [
    {
      "x": 60,
      "y": 80
    },
    {
      "x": 180,
      "y": 80
    }
  ],
  "solve_time_ms": 78,
  "captcha_type": "icon_all"
}
POST/api/v1/solve-oddOdd One Out

Izgaradaki farklı olanı bul.

Form-data alanları

  • image3x3 veya 4x4 ızgara görsel
  • grid_colsSütun sayısı (varsayılan 3)
  • grid_rowsSatır sayısı (varsayılan 3)

Cevap (200 OK)

{
  "success": true,
  "x": 230,
  "y": 230,
  "solve_time_ms": 102.2,
  "captcha_type": "odd"
}

Hata Kodları

StatusAnlamıÇözüm
401Geçersiz/eksik API keyBearer ile gönderdiğinden ve cap_ ile başladığından emin ol
403Aktif lisans yokTrial süresi dolmuş veya satın alma iptal — yeni plan başlat
429Günlük limit aşıldıPlan yükselt (starter→pro→enterprise)
200 success:falseÇözüm başarısız (düşük kalite veya captcha değişti)error alanını oku, gerekirse tekrar dene
502/503Sunucu meşgul / browser farm dolduBirkaç saniye sonra tekrar dene

Limit ve Performans

PlanGünlükEş zamanlıAylık Ücret
Starter1.0004299 TL
Pro10.0008999 TL
Enterprise100.000+özelİletişim

Görsel captcha ortalama 28ms, token captcha 8-20sn. Yüksek hacimli müşteriler için dedicated browser pool — iletişime geç.

Hemen Dene

3 gün ücretsiz deneme — kart bilgisi gerekmez, anında API key.

3 Gün Ücretsiz Başlat