Quick Start

Before you begin, make sure you have a Geelab account and can access the console.

Prerequisites

Geelab account
Console access
Determine integration platform (Web, Android, iOS, or Server)

Region Selection

Important: Before starting integration, please understand how to choose the appropriate service region. See Region Selection Guide for details.

Choose the corresponding region based on your user location:

Region	Use Case	Verification Domain	apiServers Parameter
🌏 Global	Global users or Asia-Pacific region	`cap-global.geelabapi.com`	`cap-global.geelabapi.com`
🇪🇺 Europe	EU users (GDPR compliant)	`cap-eu.geelabapi.com`	`cap-eu.geelabapi.com`
🇺🇸 North America	North American users	`cap-na.geelabapi.com`	`cap-na.geelabapi.com`

apiServers parameter: When integrating on the frontend, you must configure the apiServers parameter, which corresponds to the region you selected when creating the ID in the console.

Step 1: Get Credentials

Log in to Geelab Console
Create a new verification scenario, select the appropriate region
Get your captcha_id and captcha_key

Please keep your captcha_key secure and do not expose it in client-side code.

Step 2: Client Integration

Choose your platform and integrate the SDK:

index.html

<!DOCTYPE html>
<html>
<head>
  <script src="https://static.geelabapi.com/v4/gl4.js"></script>
</head>
<body>
  <div id="captcha"></div>

  <script>
    initGeetest4({
      captchaId: 'YOUR_CAPTCHA_ID',
      product: 'bind',
      apiServers: ['cap-global.geelabapi.com']  // Configure based on your selected region
    }, function(captcha) {
      captcha.appendTo('#captcha');
    });
  </script>
</body>
</html>

Remember to replace YOUR_CAPTCHA_ID with your actual ID obtained from the console, and configure the apiServers parameter based on the region you selected when creating the ID.

See Android Integration Guide for detailed steps.

See iOS Integration Guide for detailed steps.

Step 3: Server-Side Verification

Important: Server-side secondary verification is mandatory to ensure security.

After successful client-side verification, submit the result to your server, then call the Geelab verification API. Please use the corresponding domain based on the region you selected when registering the ID:

Global: https://cap-global.geelabapi.com/validate
Europe: https://cap-eu.geelabapi.com/validate
North America: https://cap-na.geelabapi.com/validate

Verification Request Example (Global Region)

POST https://cap-global.geelabapi.com/validate?captcha_id=YOUR_CAPTCHA_ID
Content-Type: application/x-www-form-urlencoded

lot_number=xxx&captcha_output=xxx&pass_token=xxx&gen_time=xxx&sign_token=xxx

For complete server-side verification implementation, refer to:

Server Integration Guide - Integration steps and best practices
Server API Documentation - Complete API parameters and code examples

Next Steps

Congratulations! You have completed the basic integration. Next, you can:

📖 Region Selection Guide - Learn how to choose the appropriate service region
Web Web Integration Guide - Complete Web integration documentation
📱 Mobile Integration - Android and iOS integration
📚 API Reference - Complete API documentation