Entwickler-Dokumentation

JavaScript-Referenz

window.CDPCaptcha

ElementBeschreibung
createWidget(options)Legt ein Widget auf options.element an und gibt sein Handle zurück.
attach(root?)Setzt Widgets auf alle .cdp-captcha-Elemente unterhalb von root (Standard document), die noch keins haben. Läuft beim Laden automatisch, außer das Script-Tag hat data-manual="1".
getAllWidgets()Array aller aktiven Widget-Handles.
getWidgetById(id)Handle nach ID, oder null.
getWidgetByElement(el)Handle nach Element, oder null.
reset(el?)Setzt das Widget dieses Elements zurück (oder das erste Widget).
versionVersionsangabe des Scripts.

Widget-Handle

ElementBeschreibung
idEindeutige ID dieses Widgets auf der Seite.
sitekeyDer verwendete Sitekey.
startMode„auto“, „focus“ oder „none“.
start()Fordert ein Rätsel an und beginnt mit dem Lösen (wirkungslos während des Lösens oder wenn fertig).
reset()Stoppt den Worker, leert die Antwort, kehrt in den Startzustand zurück (startet im auto-Modus erneut).
destroy()Entfernt das Widget; das Handle ist danach unbrauchbar.
getState()Name des aktuellen Zustands.
getResponse()Das Antwort-Token, „.ERROR“, „.EXPIRED“ oder eine leere Zeichenkette.
getElement()Das Element des Widgets.
getStats()Nach dem Lösen: { ms, hashes, bits, count, difficulty }.
isDestroyed()true nach destroy().
addEventListener(name, fn)Auf die Widget-Ereignisse lauschen (gleiche Namen wie die DOM-Ereignisse).
removeEventListener(name, fn)Lauschen beenden.

Attribute des Script-Tags

AttributBedeutung
data-manual="1"Widgets nicht automatisch einsetzen; rufen Sie CDPCaptcha.attach() oder createWidget() selbst auf.
data-api-endpointStandard-Basisadresse der API für alle Widgets auf der Seite.
data-compatKommaliste aus frc, recaptcha, hcaptcha: Widgets auch auf die Element-Klassen dieser Dienste setzen und das versteckte Feld wie dort benennen. Siehe Umstiegshilfe.

Antwort-Token

Eine base64url-Zeichenkette von etwa 150 Zeichen: der 32-Byte-Rätselkopf, die 32-Byte-Serversignatur und acht 8-Byte-Nonces.
Für Ihren Code ist sie undurchsichtig;
leiten Sie sie einfach an siteverify weiter.
Höchstens 16 KB werden angenommen.