Tutorials für Captcha
Hier finden Sie alle Hilfestellungen und Anleitungen für unser Captcha
Captcha Rest API
Das Sitekey/Secretkey-Modell trennt Frontend- und Backend-Kommunikation sauber:
Die Einbindung erfolgt in zwei klar getrennten Schritten:
Schritt 1 – Frontend-Einbindung: Ein Code-Tag lädt das Captcha-Widget. Ein Code-Element mit dem data-sitekey-Attribut positioniert das Widget im Formular. Das ist alles, was im Frontend notwendig ist – kein eigenes JavaScript, kein Framework-Wissen erforderlich.
Schritt 2 – Serverseitige Verifikation: Nach dem Absenden des Formulars sendet Ihr Backend das zurückgegebene Token per HTTP GET an https://api.berlinsms.de/captcha/verify.
Die Antwort ist ein einfaches JSON-Objekt mit dem Feld success: true oder success: false. Bei false lehnen Sie die Formularübermittlung ab – fertig.
Diese zwei Schritte sind unabhängig von Programmiersprache, Framework oder CMS. Das Captcha lässt sich damit in WordPress, Typo3, SAP, Oracle, Oxid, individuelle PHP-Anwendungen, Python-Backends, Node.js-Dienste und jede andere Umgebung integrieren, die HTTP-Requests absetzen kann.
Der Sitekey ist öffentlich und wird im JavaScript-Snippet des Frontend bei Ihnen verwendet.
Der Secretkey bleibt serverseitig und verifiziert das Token, das das Captcha-Widget nach erfolgreich absolvierter Challenge zurückgibt.
Sie stecken bei der Integration der API in Ihre Software fest oder möchten gerne Fragen zur Schnittstelle stellen? Es fehlt ein Thema in unserer Dokumentation? Dann kontaktieren Sie unseren Support.