Zum Hauptinhalt springen

MTCaptcha-Schnellstart

Sie benötigen ein registriertes Konto (kostenlose Testversion verfügbar) und Ihren <SiteKey>, um MTCaptcha auf Ihrer eigenen Website zu verwenden.

Der beste Ausgangspunkt, um herauszufinden, wie Sie das MTCaptcha captcha JavaScript-Plugin in Ihre Website einbetten können, ist die Verwendung unseres MTCaptcha Code Builder.

Code Generator Snippet

OR

Schritt 1: JavaScript-Code-Snippet einbetten​

Sie können den folgenden JavaScript-Codeausschnitt in Ihre HTML-Seite kopieren. Bitte ersetzen Sie den <SiteKey> durch Ihren sitekey aus dem Admin-Portal.

<html>
<head>
    <!-- MTCaptcha JavaScript configuration and import, copy start -->
    <script>
    var mtcaptchaConfig = {
      "sitekey": "<SiteKey>"
    };
   (function(){
      var mt_service = document.createElement('script');
      mt_service.async = true;
      mt_service.src = 'https://service.mtcaptcha.com/mtcv1/client/mtcaptcha.min.js';
      (document.getElementsByTagName('head')[0] 
       || document.getElementsByTagName('body')[0]).appendChild(mt_service);

      var mt_service2 = document.createElement('script');
      mt_service2.async = true;
      mt_service2.src = 'https://service2.mtcaptcha.com/mtcv1/client/mtcaptcha2.min.js';
      (document.getElementsByTagName('head')[0] 
       || document.getElementsByTagName('body')[0]).appendChild(mt_service2);
   })();
   </script>
   <!-- MTCaptcha JavaScript configuration and import, copy end -->
</head>
<body>    
    <form ... >
        <!-- MTCaptcha Anchor DOM, copy start -->
        <div class="mtcaptcha"></div>
        <!-- MTCaptcha Anchor DOM, copy end -->
    </form>  
</body>
<html>

Schritt 2: Überprüfen Sie validiertes Token auf der Serverseite mit einem API-Aufruf​

Bei erfolgreicher Captcha-Verifizierung wird ein mtcaptcha-verifiziertes Token (String) erstellt und als versteckte Eingabe in das HTML-Formular eingefügt

<input type=’hidden’ name=’mtcaptcha-verifiedtoken’  value=’<token>’  />

Der Wert dieses mtcaptcha-verifiedtoken Formulars muss serverseitig über einen HTTP(S) API call.

HTTP(S) API:

https://service.mtcaptcha.com/mtcv1/api/checktoken?
privatekey=<privatekey>&token=<token>

HTTP Method:

GET

Parameters​

  • <privatekey>

The PrivateKey secret. (Required)
Dies ist der geheime Schlüssel und kann im MTCaptcha-Admin-Portal abgerufen werden.

  • <token>

The verified token string. (Required)
Dies ist der Wert der Eingabe mtcaptcha-verifiedtoken.

SBeispiel einer erfolgreichen API-Antwort (JSON)​

{
  "success": true,
  "tokeninfo": {
    "v": "1.0",
    "code": 201,
    "codeDesc": "valid:captcha-solved",
    "tokID": "ae1e60a1e249c217cb7b05c4dba8dd0d",
    "timestampSec": 1552185983,
    "timestampISO": "2019-03-10T02:46:23Z",
    "hostname": "some.example.com",
    "isDevHost": false,
    "action": "",
    "ip": "10.10.10.10"
  }
}

Beispiel für eine API-Fehlerantwort (JSON)​

{
  "success": false,
  "fail_codes": [
    "token-expired"
  ],
  "tokeninfo": {
    "v": "1.0",
    "code": 201,
    "codeDesc": "valid:captcha-solved",
    "tokID": "25eff0c56a227781408a95a053c36b65",
    "timestampSec": 1552185729,
    "timestampISO": "2019-03-10T02:42:09Z",
    "hostname": "some.example.com",
    "isDevHost": false,
    "action": "",
    "ip": "10.10.10.10"
  }
}