Dokumentation
Alles, was Sie brauchen, um Ihre erste Lösung zu senden und für ihre Akzeptanz zu sorgen.
Ihre erste Lösung in vier Schritten
- 01Konto erstellen
Registrieren Sie sich und bestätigen Sie Ihre E-Mail-Adresse. Neue Konten erhalten 0,10 $ kostenloses Guthaben, ohne Karte.
- 02API-Schlüssel erstellen
Im Dashboard unter „Schlüssel“. Schlüssel beginnen mit cn- und werden nur einmal angezeigt – bewahren Sie Ihren sicher auf.
- 03Lösung anfordern
Senden Sie type, sitekey und Seiten-URL per POST an /v1/solve?wait=60 mit Authorization: Bearer cn-…
- 04Token absenden
Setzen Sie das Token dort ein, wo die Seite es erwartet, und senden Sie innerhalb von etwa zwei Minuten ab.
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 }Wählen Sie Ihre Integration
Lauffähige Beispiele gegen die echte API, mit den Fallstricken des jeweiligen Tools.
So werden Ihre Tokens akzeptiert
Gültige, aber abgelehnte Tokens haben meist eine dieser Ursachen.
Ein Token, das auf einer anderen IP oder in einem anderen Browser erzeugt wurde als dem, der es absendet, ist die häufigste Ursache für Ablehnungen.
Senden Sie bei reCAPTCHA v3 denselben Action-Namen, den die Seite verwendet. Eine Abweichung senkt den Score unbemerkt.
Tokens laufen nach etwa zwei Minuten ab und sind nur einmal verwendbar. Lösen Sie direkt vor dem Absenden – und bei jedem erneuten Versuch erneut.
Blockierend oder Polling
Mit ?wait=N (bis zu 120 Sekunden) wartet der Solve-Request, bis das Ergebnis vorliegt. Ohne den Parameter erhalten Sie sofort eine Task-id und fragen GET /v1/task/{id} alle fünf Sekunden ab. Eine bezahlte Lösung bleibt zehn Minuten lang abrufbar, eine abgebrochene Verbindung kostet Sie also nicht die Lösung.
Abrechnung
Berechnet wird nur, wenn eine Lösung erfolgreich ist; fehlgeschlagene Lösungen sind kostenlos. Jede Response enthält ihre cost, und GET /v1/balance liefert Ihr verbleibendes Guthaben. Die Preise pro Typ finden Sie auf der Preisseite.
Schlüssel und Teams
Ein Konto kann bis zu zehn aktive Schlüssel haben. Benennen Sie sie nach Projekt oder Kunde, dann zeigt das Dashboard die Nutzung pro Schlüssel; das Widerrufen eines Schlüssels wirkt sich nicht auf die anderen aus.
FAQ zur Dokumentation
Gibt es ein offizielles SDK?
Ja. Open-Source-SDKs für Python, Node.js und TypeScript, Go und PHP liegen auf GitHub. Nötig ist keines davon: CaptchaNo ist eine schlichte REST-API mit JSON als Ein- und Ausgabe, daher funktioniert jeder HTTP-Client, und die Integrationsleitfäden zeigen die wenigen Zeilen für jede Sprache und jedes Tool.
Welche Challenge-Typen werden unterstützt?
reCAPTCHA v2 (Checkbox und unsichtbar), reCAPTCHA v3, reCAPTCHA-Enterprise-Widgets im Checkbox-Stil, Cloudflare Turnstile, DataDome sowie Bild- und Text-Captchas, alle über dasselbe Request-Format.
Brauche ich einen Proxy?
Für DataDome ja, denn das Cookie ist an die IP gebunden, die es erhalten hat. Bei Token-Challenges ist er optional, verbessert aber die Akzeptanz, weil die Website vergleichen kann, wo das Token erzeugt und wo es abgesendet wurde.
Was passiert, wenn eine Lösung fehlschlägt?
Der Task endet mit dem Status failed und einem Fehlercode, und Ihnen wird nichts berechnet. Versuchen Sie es mit einem neuen Request erneut.
Wo sehe ich meine Nutzung?
Das Dashboard listet jede Lösung mit Typ, Dauer, Kosten und Schlüssel auf und zeigt Ihr Guthaben sowie die Ausgaben pro Schlüssel.
Hilfreiche Anleitungen
Bereit zum Loslegen?
Starten Sie mit einer kostenlosen 3-tägigen Testphase und zahlen Sie danach pro erfolgreicher Lösung, wenn Ihr Traffic wächst. Für die Testphase ist keine Karte nötig.