Integration Guide

1. Get an API Key

Email chonghao@hawltechs.com with:

• Your company name
• Estimated monthly verifications
• When you want to start

You'll receive a key like hum_live_xxxxxxxxxxxxxxxx. Pilot keys are free for 2 weeks and include 1,000 verifications.

2. How It Works

3. Face Verification

Step 1: Request a challenge

curl -X POST https://humanity.hawltechs.com/api/verify/challenge \
  -H "x-api-key: hum_live_YOUR_KEY"

# Response:
# {
#   "challenge_id": "abc-123",
#   "action": "blink_twice",
#   "expires_in": 30
# }

Step 2: User completes liveness

Redirect users to our hosted verification page with your API key in the URL. Verifications are attributed to your pilot account automatically:

https://humanity.hawltechs.com/verify/face?api_key=hum_live_YOUR_KEY

For server-side integrations, pass x-api-key on every API call instead.

Step 3: Verify result (server-side)

curl -X POST https://humanity.hawltechs.com/api/verify \
  -H "Content-Type: application/json" \
  -H "x-api-key: hum_live_YOUR_KEY" \
  -d '{
    "embedding": [0.12, 0.34, ...128 numbers],
    "challenge_id": "abc-123",
    "action_results": { "blink_twice": true }
  }'

# Response:
# {
#   "liveness_passed": true,
#   "is_duplicate": false,
#   "user_id": "uuid-here",
#   "similarity_score": 0.0
# }

4. Typing Verification (Alternative)

No camera required. Users type a sentence; we analyze their rhythm.

curl -X POST https://humanity.hawltechs.com/api/verify/typing \
  -H "Content-Type: application/json" \
  -H "x-api-key: hum_live_YOUR_KEY" \
  -d '{
    "passed": true,
    "wpm": 42,
    "iki_variance": 3400,
    "paste_detected": false,
    "duration_ms": 8500
  }'

Or link users to the hosted typing page:

https://humanity.hawltechs.com/verify/typing?api_key=hum_live_YOUR_KEY

5. View Your Dashboard

Track verifications, fraud detection rates, and recent activity:

https://humanity.hawltechs.com/dashboard?key=hum_live_YOUR_KEY

Go to Dashboard →

6. Pricing

7. FAQ