Quick Start (快速开始)

Base Api Endpoint: https://api.hardcaptcha.com

Get your API key

Your API requests are authenticated using API key. Any request that doesn't include an API key will return an error.

You can generate an API key from your Dashboard at any time.

Install the library

Coming soon

Make your first request

Example with recaptchaV2Token

Create task

Take a look at how you might call this method using:

curl

curl -X 'POST' \
  '{BASE_API_ENDPOINT}/tasks' \
  -H 'accept: application/json' \
  -H 'x-api-key: J7vZMU044xxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "RECAPTCHA_V2",
  "data": {
    "websiteUrl": "https://democaptcha.com/demo-form-eng/recaptcha-2.html",
    "websiteKey": "6LfGqN0UAAAAAFdGo4OSj5Awi8hM_9kmR7VfXUP2"
  }
}'

NodeJS/ JavaScript

const url = '{BASE_API_ENDPOINT}/tasks';
const apiKey = 'J7vZMU044xxxxxxxxxxxxxx';

const payload = {
  type: 'RECAPTCHA_V2',
  data: {
    websiteUrl: 'https://democaptcha.com/demo-form-eng/recaptcha-2.html',
    websiteKey: '6LfGqN0UAAAAAFdGo4OSj5Awi8hM_9kmR7VfXUP2'
  }
};

fetch(url, {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'x-api-key': apiKey,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
})
  .then(response => response.json())
  .then(data => {
    console.log(data);
  })
  .catch(error => {
    console.error('Error:', error);
  });

Python

import requests
import json

url = 'https://khoivc.proxy.h2-best.com/tasks'
api_key = 'J7vZMU044xxxxxxxxxxxxxx'

payload = {
    'type': 'RECAPTCHA_V2_TOKEN',
    'data': {
        'websiteUrl': 'https://democaptcha.com/demo-form-eng/recaptcha-2.html',
        'websiteKey': '6LfGqN0UAAAAAFdGo4OSj5Awi8hM_9kmR7VfXUP2'
    }
}

headers = {
    'accept': 'application/json',
    'x-api-key': api_key,
    'Content-Type': 'application/json',
}

response = requests.post(url, headers=headers, data=json.dumps(payload))

Get task result

Call this method every 0.5 second if you don't have a server to handle the callback URL (posted on task creation)