1.0.0 • Published 1 year ago

@swetrix/captcha-validator v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Swetrix CAPTCHA validator

This is a wrapper for the Swetrix CAPTCHA server-side validation API.\ It is used to validate the user's response to the CAPTCHA.\ Read more about server-side validation at https://docs.swetrix.com/captcha/server-side-validation

Installation

npm install @swetrix/captcha-validator

Usage

You can use this package in your Node.js (or NestJS, ExpressJS, etc.) project to validate the user's response to the CAPTCHA.\ The package exports a single function validateToken which takes arguments listed below and returns a Promise.

ArgumentTypeDescriptionRequired
tokenstringThe token returned by the CAPTCHA widget.YES
secretKeystringYour CAPTCHA project secret key.YES
apiURLstringThe API URL to use (default: https://api.swetrix.com/captcha), this one may be used in case you're selfhosting the API.NO

Here's an example of how to use the package in your project:

const { validateToken } = require('@swetrix/captcha-validator')
// or
import { validateToken } from '@swetrix/captcha-validator'

// somewhere inside the controller of your form where the CAPTCHA is used
validateToken(
  'CAPTCHA_TOKEN',
  'YOUR_SECRET_KEY',
).then((result) => {
  const [status, data] = result
  // status is a boolean, true if the token is valid, false otherwise
  // data is an error message if status is false
  console.log(status, data)
})

License

This library is licenced under the MIT License - see the LICENSE file for details.

Donate

You can support the project by donating us at https://ko-fi.com/andriir \ We can only run our services by once again asking for your financial support!

1.0.0

1 year ago

0.0.5

1 year ago

0.0.4

1 year ago

0.0.3

1 year ago

0.0.2

1 year ago

0.0.1

1 year ago