Subscribe to Newsletter

​

Overview

​

Spam Protection

• Honeypot: a hidden website field must be empty. Any non-empty value returns 400.
• Rate limit: 3 attempts per IP per hour (Redis-backed sliding window).
• Silent duplicate: already-subscribed emails return 200 silently — no error, no resent welcome email. This prevents email enumeration and harvesting attacks.

​

Request Fields

​

Response Fields

curl -X POST https://api.aioka.io/v1/newsletter/subscribe \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "name": "Alice"}'

import httpx

resp = httpx.post(
    "https://api.aioka.io/v1/newsletter/subscribe",
    json={"email": "user@example.com", "name": "Alice"},
)
print(resp.json())

{
  "message": "Successfully subscribed to newsletter"
}

{
  "detail": "Invalid email address"
}

{
  "detail": "Too many requests. Please try again later."
}

​

What Happens Next

1. Your email is stored in the newsletter_subscribers table.
2. A welcome email is sent to you via Resend with the subject “Welcome to AIOKA — The Council Is Now Watching For You 👻”.
3. The AIOKA owner is notified via Telegram.
4. You’ll start receiving verdicts, council rulings, and market intelligence directly from the Judiciary Engine.