Getting Started

Just want to draw on a dictator? Go to the homepage. No account or API key needed. It just works.

Want EVANDALIZE on your own site? This guide is for you. Get an API key, embed our widget, and verify users on your platform. Takes about 5 minutes.

Want to understand the concept first? Read how EVANDALIZE works.

01

Create an Account

Sign up at the EVANDALIZE dashboard. Free tier includes 100 verifications per hour. No credit card required.

02

Get Your API Key

From the dashboard, generate an API key. You will get two keys: a public key for the widget and a secret key for server-side verification. Keep the secret key out of client-side code.

Public key: evdl_pk_... (safe for frontend)

Secret key: evdl_sk_... (server only)

03

Choose Your Integration

Two options: the drop-in widget (fastest) or the REST API (full control). Most teams start with the widget and move to the API if they need custom UI.

Widget

One script tag. Handles the entire challenge flow. Fires a callback with the clearance code.

REST API

Full control over the challenge UI and verification flow. Build your own experience.

04

Add to Your Site

Widget Integration

Add this to any page where you want the EVANDALIZE challenge. The widget renders inside the container element and calls onVerified when the user passes.

<!DOCTYPE html>
<html>
<head>
  <title>Sign Up</title>
</head>
<body>
  <form id="signup-form" action="/register" method="POST">
    <input type="text" name="email" placeholder="Email" />
    <input type="password" name="password" placeholder="Password" />

    <!-- EVANDALIZE widget renders here -->
    <div id="evandalize-widget"></div>
    <input type="hidden" id="clearance" name="clearance" />

    <button type="submit">Sign Up</button>
  </form>

  <script src="https://evandalize.com/widget.js"></script>
  <script>
    Evandalize.init({
      container: "#evandalize-widget",
      apiKey: "YOUR_PUBLIC_KEY",
      onVerified: function(clearanceCode) {
        document.getElementById("clearance").value = clearanceCode;
      },
      onError: function(error) {
        console.error("EVANDALIZE error:", error);
      }
    });
  </script>
</body>
</html>

Server-Side Verification

When your form is submitted, verify the clearance code on your server before processing the request. Never trust the client alone.

// Node.js / Express example
app.post("/register", async (req, res) => {
  const { clearance, email, password } = req.body;

  // Verify the clearance code with EVANDALIZE
  const check = await fetch(
    `https://evandalize.com/api/verify?sessionId=${clearance}`,
    {
      headers: {
        Authorization: "Bearer YOUR_SECRET_KEY",
      },
    }
  );

  const result = await check.json();

  if (result.status !== "verified") {
    return res.status(403).json({
      error: "EVANDALIZE verification failed"
    });
  }

  // Proceed with registration
  // ...
});

Next Steps

  • Read the full API documentation for all endpoints and webhook configuration
  • Set up webhooks for async verification in your challenge creation request
  • Upgrade to Team or Business for higher rate limits and priority support
Go to DashboardAPI Reference