@swetrix/captcha-validator
TypeScript icon, indicating that this package has built-in type declarations

1.0.0 • Public • Published

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.

Argument Type Description Required
token string The token returned by the CAPTCHA widget. YES
secretKey string Your CAPTCHA project secret key. YES
apiURL string The 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!

Package Sidebar

Install

npm i @swetrix/captcha-validator

Weekly Downloads

0

Version

1.0.0

License

MIT

Unpacked Size

31.9 kB

Total Files

17

Last publish

Collaborators

  • blaumaus