Skip to main content

​
Authentication

All AIOKA Intelligence API endpoints (except /v1/health and /v1/keys/generate) require an API key passed in the X-API-Key header.

​
API Key Format

aik_{tier}_{20 random characters}
Examples:
  • aik_free_a1b2c3d4e5f6g7h8i9j0 — Free tier
  • aik_basic_x9y8z7w6v5u4t3s2r1q0 — Basic tier
  • aik_pro_m1n2o3p4q5r6s7t8u9v0 — Pro tier

​
Making Authenticated Requests

Include your key in the X-API-Key header on every request: 
curl https://api.aioka.io/v1/verdict/latest \
  -H "X-API-Key: aik_free_your_key_here"

​
Error Responses

StatusErrorCause
401missing_api_keyNo X-API-Key header
401invalid_api_keyKey not found in database
401key_inactiveKey has been deactivated
403tier_requiredEndpoint requires a higher tier
429daily_limit_exceededDaily call quota exhausted
429rate_limit_exceededPer-minute rate limit hit

​
Security

  • Store your key securely — treat it like a password
  • Never commit it to version control
  • Use environment variables: export AIOKA_API_KEY=aik_free_...
  • The key is shown once at generation and cannot be recovered

​
Get Your Free Key

curl -X POST https://api.aioka.io/v1/keys/generate \
  -H "Content-Type: application/json" \
  -d '{"name": "My Project", "email": "you@example.com"}'
→ Full key generation docs