Saltar al contenido principal

MTCaptcha inicio rápido

Necesitará tener una cuenta registrada (Prueba gratuita disponible) y su <SiteKey> para usar MTCaptcha en su propio sitio web.

El mejor lugar para comenzar y descubrir cómo incrustar el complemento JavaScript de MTCaptcha en su sitio web es utilizando nuestro Generador de Código.

Code Generator Snippet

O

Paso 1: Insertar el fragmento de código JavaScript​

Puede copiar el siguiente fragmento de código JavaScript en su página HTML. Asegúrese de reemplazar <SiteKey> con su clave de sitio obtenida del Portal de Administración.

<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>

Paso 2: Verificar el token validado en el servidor con una llamada API​

Tras la verificación exitosa del captcha, se creará un token verificado de MTCaptcha (cadena) y se insertará en el formulario HTML como un campo oculto.

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

El valor de este formulario ‘mtcaptcha-verifiedtoken’ debe verificarse en el servidor mediante una llamada API HTTP(S).

HTTP(S) API:

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

HTTP Method:

GET

Parámetros​

  • <privatekey>

La clave secreta privada. (Obligatorio)
Esta es la clave secreta y se puede obtener en el. Portal de Administración de MTCaptcha.

  • <token>

La cadena del token verificado. (Obligatorio)
Este es el valor del campo de entrada mtcaptcha-verifiedtoken.

Ejemplo de respuesta exitosa de la API (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"
  }
}

Ejemplo de respuesta fallida de la API (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"
  }
}