Java / Kotlin
Das nachfolgende Tutorial zeigt Ihnen, wie Sie Trustcaptcha in Java oder Kotlin integrieren können.
Vorbereitung
Voraussetzungen
- Ein Konto bei Trustcaptcha und ein existierendes CAPTCHA.
- Ein Backend mit Java oder Kotlin, in welches Trustcaptcha integriert werden soll.
Wissen (empfohlen)
- Basiswissen in Java und/oder Kotlin.
- Verständnis für die grundlegende Funktionsweise von Trustcaptcha sowie vom Backend-Prozess.
Abhängigkeit hinzufügen
Um die Trustcaptcha-Bibliothek verwenden zu können, müssen Sie zuerst die entsprechenden Abhängigkeiten in Ihr Projekt einfügen.
Maven
Fügen Sie die folgende Abhängigkeit in Ihre pom.xml Datei ein, um Trustcaptcha mit Maven verwenden zu können.
Gradle
Fügen Sie die folgende Abhängigkeit in Ihre build.gradle oder build.gradle.kts Datei ein, um Trustcaptcha mit Gradle-Groovy oder Gradle-Kotlin verwenden zu können.
Bibliothek verwenden
Nachstehend erfahren Sie, wie Sie die Bibliothek verwenden können.
Ergebnis abrufen
Sie können das Verifikationsergebnis mit Hilfe der Methode getVerificationResult() der Klasse CaptchaManager von unseren Servern abrufen. Dafür müssen Sie Ihren secret-key und den Verifikationstoken angeben.
Ergebnis verwenden
Wenn Sie das Verifikationsergebnis erfolgreich abgerufen haben, können Sie, basierend darauf, Ihre nächsten Schritte planen. Eine konkrete Übersicht über alle enthaltenden Informationen des Verifikationsergebnisses und deren jeweiligen Bedeutungen finden Sie Das Backend.
Beispiel mit Spring
Das untenstehende Beispiel zeigt eine mögliche Implementierung mit dem Framework Spring Boot. Mit einer POST-Request auf /api/example wird der Verifikationstoken innerhalb des RequestBody verificationResult übermittelt. Anschließend wird das Ergebnis vom Server abgerufen. Sollte die Verifikationstoken nicht bestanden worden sein oder der Bot-Score über 0.5 liegen, wird beispielhaft eine Warnung ausgegeben. Abschließend wir das gesamte Ergebnis an den Client zurück gegeben.
Das gesamte Beispiel inklusive Quellcode finden Sie auf Github.