Overview

The databurger API gives you programmatic access to the training-data pipeline: search and purchase standard datasets, publish video-evaluation tasks, drive labeling jobs, query the scenario library, and read ledger and invoice data. Everything is HTTPS + JSON.

Quick start

Copy# 1) Sign in
curl -X POST "https://aidataburger.com/api/v1/login-password" \
  -H "Content-Type: application/json" \
  -d '{"phone":"13800000000","password":"********","role":"buyer"}'

# Response
{ "token": "3f9a1c...", "user": { "id": 1, "phone": "13800000000", "role": "buyer", "balance": 4010.0 } }

# 2) Verify the token
curl "https://aidataburger.com/api/v1/me" -H "Authorization: Bearer $DB_TOKEN"

Authentication

• Using the token: send Authorization: Bearer <token> on every request. An expired token returns 401 {"detail":"..."}; sign in again.
• Brute-force protection: five failed sign-in attempts for the same phone within 15 minutes trigger a temporary lock, returning 429.
• Roles: publishing tasks, topping up and buying datasets require buyer; claiming and submitting require judge. Cross-role calls return 403.
• Handling: the token is equivalent to account credentials. Never embed it in browser or mobile code.

Datasets

Copy# Search datasets
curl "https://aidataburger.com/api/v1/datasets?domain=medical"

# Response (excerpt)
[ { "id": 6, "title": "Medical image segmentation set", "domain": "medical",
    "formats": ["json","coco"], "price": 5990.0, "samples": 1500, "status": "on" } ]

Tasks and state machine

Task lifecycle: open → assigned → submitted → done. Funds settle only on the last step.

Labeling jobs

type values: video_judge, trajectory, pcd_6dof.

Scenario library

Entity-operation SOP library. Publicly readable.

Account and funds

Public platform metrics

The "live platform data" block on the homepage calls this endpoint. No authentication required.

Copycurl "https://aidataburger.com/api/v1/metrics/public"

# Response
{ "online": 101, "today": 0, "review": 18.5, "pass": 92.0,
  "cities": 12, "batches": 4, "updated_at": "2026-10-02T14:41:16.343607" }

Reports

The ticket number is generated server-side and returned only after the record is persisted.

Error codes

Calling conventions

• Rate limits: no QPS limit on business endpoints in v1; only the sign-in endpoint has failed-attempt protection.
• Billing: read endpoints are free; tasks and purchases are billed by amount.
• Timeouts: 5s connect, 30s read. Retry only on 5xx and network errors with exponential backoff; never retry 4xx.
• Idempotency: publishing, purchasing and top-ups debit immediately. Do not blindly replay after a timeout - check /ledger first.

Webhooks

SDKs and samples

Python (standard library only)

Copyimport json, urllib.request

BASE = "https://aidataburger.com/api/v1"

def call(method, path, token=None, body=None):
    data = json.dumps(body).encode() if body else None
    req = urllib.request.Request(BASE + path, data=data, method=method)
    req.add_header("Content-Type", "application/json")
    if token:
        req.add_header("Authorization", "Bearer " + token)
    with urllib.request.urlopen(req, timeout=30) as r:
        return json.loads(r.read().decode())

# Sign in
resp = call("POST", "/login-password", body={
    "phone": "13800000000", "password": "********", "role": "buyer"})
token = resp["token"]

# Search datasets
for ds in call("GET", "/datasets?domain=medical"):
    print(ds["id"], ds["title"], ds["samples"], ds["price"])

JavaScript (native fetch)

Copyconst BASE = "https://aidataburger.com/api/v1";

async function call(path, { method = "GET", token, body } = {}) {
  const r = await fetch(BASE + path, {
    method,
    headers: {
      "Content-Type": "application/json",
      ...(token ? { Authorization: `Bearer ${token}` } : {}),
    },
    body: body ? JSON.stringify(body) : undefined,
  });
  if (!r.ok) throw new Error(`${r.status} ` + await r.text());
  return r.json();
}

// Public endpoint, no token needed
const metrics = await call("/metrics/public");

const { token } = await call("/login-password", {
  method: "POST",
  body: { phone: "13800000000", password: "********", role: "buyer" },
});
const me = await call("/me", { token });

Changelog