API Documentation

Welcome to the official developer documentation for the Wirbelpfote Captcha Service. Seamlessly integrate secure, unpredictable verification sessions directly into your applications or Discord bots.

Base URL

https://p.api.wirbelpfote.de

GET Create Session

Generates a completely new, unique verification session in the backend and returns a ready-to-use URL that you can send directly to a user via Discord DMs.

/captcha-create

Response Body (201 Created)

JSON

{
  "success": true,
  "message": "Verification session created successfully.",
  "session_id": "2885286586",
  "verification_url": "https://verify.captcha.wirbelpfote.de/?session=2885286586"
}

Implementation Example (Discord.js)

JavaScript

// Fetch session from the API
const response = await fetch('https://p.api.wirbelpfote.de/captcha-create');
const data = await response.json();

if (data.success) {
    // Send the link privately to the Discord user
    await interaction.reply({
        content: `Please verify your account here: ${data.verification_url}`,
        ephemeral: true
    });
}

POST Verify / Check Status

This endpoint is called to check the current verification status of a specific session using its unique session ID.

/captcha-status

Request Body (Payload)

JSON

{
  "session_id": "2885286586"
}

Success Response (200 OK)

JSON

{
  "success": true,
  "session_id": "2885286586",
  "status": "true"
}