Aiatera API Documentation

Official REST API for integrating Aiatera digital products, automated ordering, and wallet management into your applications.

Base URL: https://aiatera.online

Introduction

The Aiatera API gives you programmatic access to live product catalogs, stock levels, automated ordering, and wallet operations. All requests and responses use JSON. All endpoints are served over HTTPS — plain HTTP is not supported.

Authentication

Authenticate every request with your secret API key, available in the API Key dashboard page. Send it in the X-API-Key header:

X-API-Key: your-api-key-here

Alternatively, a Bearer token format is accepted:

Authorization: Bearer your-api-key-here

Rate Limits

When you exceed a limit, the API returns 429 Too Many Requests. Back off and retry after the window resets.

Error Codes

Products

curl -s "https://aiatera.online/api/supplier/products" \
  -H "X-API-Key: your-api-key"

{
  "products": [
    {
      "id": "elevenlabs_creator_3_months",
      "name": "ElevenLabs Creator — 3 Months",
      "category": "ai_chat",
      "price": 13.0,
      "originalPrice": 18.2,
      "inStock": true,
      "stock": 42,
      "supplier": "dc"
    }
  ]
}

curl -s "https://aiatera.online/api/supplier/products/elevenlabs_creator_3_months" \
  -H "X-API-Key: your-api-key"

Orders

curl -s -X POST "https://aiatera.online/api/supplier/orders" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{"productId": "elevenlabs_creator_3_months"}'

{
  "success": true,
  "order": {
    "id": "8f2c1a9e-...",
    "productId": "elevenlabs_creator_3_months",
    "amount": 13.0,
    "status": "processing"
  }
}

Account & Wallet

{
  "user": {
    "id": "3f873642-...",
    "name": "johndoe",
    "email": "john@example.com",
    "balance": 25.4,
    "role": "user"
  }
}

Quickstart

End-to-end example: list products, order one, poll until delivered.

const BASE = "https://aiatera.online";
const headers = { "Content-Type": "application/json", "X-API-Key": "your-api-key" };

// 1. Pick a product
const { products } = await fetch(BASE + "/api/supplier/products", { headers }).then(r => r.json());
const product = products.find(p => p.inStock);

// 2. Order it (server verifies price & balance)
const { order } = await fetch(BASE + "/api/supplier/orders", {
  method: "POST", headers,
  body: JSON.stringify({ productId: product.id })
}).then(r => r.json());

// 3. Poll for delivery
let result;
do {
  await new Promise(r => setTimeout(r, 3000));
  result = await fetch(BASE + `/api/supplier/orders/${order.id}/status`, { headers }).then(r => r.json());
} while (result.status === "pending" || result.status === "processing");

console.log("Delivered:", result.result);

import requests, time

BASE = "https://aiatera.online"
headers = {"X-API-Key": "your-api-key", "Content-Type": "application/json"}

# 1. Pick a product
products = requests.get(f"{BASE}/api/supplier/products", headers=headers).json()["products"]
product = next(p for p in products if p["inStock"])

# 2. Order it
order = requests.post(f"{BASE}/api/supplier/orders", headers=headers,
                      json={"productId": product["id"]}).json()["order"]

# 3. Poll for delivery
while True:
    r = requests.get(f"{BASE}/api/supplier/orders/{order['id']}/status", headers=headers).json()
    if r["status"] not in ("pending", "processing"):
        break
    time.sleep(3)

print("Delivered:", r.get("result"))