让数据，
触手可及。

收件人：robloxbot@astudlox.top
主题：Astudlox API 凭证申请 - <项目名称>

1. 申请用途：
2. 申请理由：
3. 申请项目证明等：

-H 'X-App-ID: <APP_ID>' \
-H 'X-API-Key: <API_KEY>'

# 通用变量（替换为真实值）
APP_ID='<APP_ID>'
API_KEY='<API_KEY>'
RID='<ROBLOX_USER_ID>'
BASE='https://api.astudlox.top'

# 1) 汇总：积分 + 等级 + 经验 + 身份组 + 违规记录
curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  "$BASE/api/v1/users/$RID"

# 2) R 点积分
curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  "$BASE/api/v1/users/$RID/points"

# 3) 等级
curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  "$BASE/api/v1/users/$RID/level"

# 4) 经验值
curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  "$BASE/api/v1/users/$RID/experience"

# 5) 身份组
curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  "$BASE/api/v1/users/$RID/roles"

# 6) 违规记录
curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  "$BASE/api/v1/users/$RID/violations"

# 7) 违规账号查询（限额 60 次/分钟）
curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  "$BASE/api/v1/users/$RID/violation-status"

# 路径参数写法
curl -sS -H "X-App-ID: <APP_ID>" -H "X-API-Key: <API_KEY>" \
  'https://api.astudlox.top/api/v1/users/<ROBLOX_USER_ID>/violation-status'

# 查询参数写法（入参名 userId）
curl -sS -H "X-App-ID: <APP_ID>" -H "X-API-Key: <API_KEY>" \
  'https://api.astudlox.top/api/v1/violation-status?userId=<ROBLOX_USER_ID>'

// 违规账号：isViolation = true
{
  "success": true,
  "code": 200,
  "message": "ok",
  "data": {
    "userId": "10726271939",
    "username": "ASDTVWM",
    "isViolation": true,
    "violationStatus": "violation",
    "violationLabel": "违规账号",
    "hasHistoricalViolation": true,
    "activeViolationCount": 1,
    "violationDetail": {
      "targetId": "10726271939",
      "targetType": "user",
      "targetName": "ASDTVWM",
      "violationReason": "人工审核确认含敏感信息",
      "severity": "high",
      "sourceViolationId": "A1788868780194-fb487",
      "addedBy": "manual",
      "hitCount": 0,
      "expired": false,
      "addedAtIso": "2026-09-08T20:20:03",
      "expiresAtIso": "2027-09-08T20:21:45"
    },
    "recordSource": "violation_lib"
  },
  "meta": { "requestId": "…", "elapsedMs": 0.52, "cached": false }
}

// 正常账号：isViolation = false
{
  "success": true,
  "code": 200,
  "message": "ok",
  "data": {
    "userId": "10404804391",
    "username": "ainixiaofan",
    "isViolation": false,
    "violationStatus": "normal",
    "violationLabel": "正常账号",
    "hasHistoricalViolation": false,
    "activeViolationCount": 0,
    "violationDetail": null,
    "recordSource": "user_local"
  },
  "meta": { "requestId": "…", "elapsedMs": 0.41, "cached": false }
}

# 查询参数写法（与路径参数等价）
curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  "$BASE/api/v1/points?robloxuserid=$RID"

# 健康检查（无需鉴权，不含业务数据）
curl -sS "$BASE/health"

curl -sS -H "X-App-ID: $APP_ID" -H "X-API-Key: $API_KEY" \
  -H "X-Request-ID: order-20260909-0001" \
  "$BASE/api/v1/users/$RID/points"

import json
import urllib.request

BASE = "https://api.astudlox.top"
HEADERS = {
    "X-App-ID": "<APP_ID>",
    "X-API-Key": "<API_KEY>",
}

def fetch(roblox_user_id: str, resource: str = "") -> dict:
    url = f"{BASE}/api/v1/users/{roblox_user_id}{resource}"
    req = urllib.request.Request(url, headers=HEADERS, method="GET")
    with urllib.request.urlopen(req, timeout=10) as resp:
        return json.loads(resp.read().decode("utf-8"))

data = fetch("<ROBLOX_USER_ID>", "/points")
print(data["data"]["aggregate"]["currentPointsTotal"])

{
  "success": true,
  "code": 200,
  "message": "ok",
  "data": {
    "robloxUserId": "10404804391",
    "accounts": [
      {
        "userId": "349B816AA707E74A6E6039D5AE923C32",
        "bound": true,
        "current": true,
        "bindingName": "ainixiaofan",
        "lastBindTime": 1757000000000,
        "lastBindTimeIso": "2026-09-04T22:13:20",
        "points": { "currentPoints": 195, "...": "..." },
        "level": { "level": 1, "name": "新手", "...": "..." },
        "experience": { "expIntoLevel": 30, "expToNextLevel": 230, "...": "..." },
        "roles": { "systemRoles": [], "groups": [], "...": "..." }
      }
    ],
    "violations": {
      "robloxUserId": "10404804391",
      "violationLib": [],
      "violationLibCount": 0,
      "accounts": []
    },
    "aggregate": {
      "accountCount": 1,
      "currentAccounts": 1,
      "currentPointsTotal": 195,
      "maxLevel": 1,
      "roleIds": [],
      "violationLibCount": 0
    }
  },
  "meta": {
    "requestId": "b3f1c2d4e5f60718293a4b5c6d7e8f90",
    "elapsedMs": 1.234,
    "cached": false
  }
}

{
  "success": false,
  "code": 401,
  "error": {
    "code": "INVALID_CREDENTIALS",
    "message": "AppID 或 API Key 无效",
    "details": { "requiredHeaders": ["X-App-ID", "X-API-Key"] }
  },
  "meta": { "requestId": "b3f1c2d4e5f60718293a4b5c6d7e8f90" }
}

HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0

{
  "success": false,
  "code": 429,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "请求过于频繁：每 60 秒最多 120 次，请稍后重试",
    "details": { "limit": 120, "windowSeconds": 60, "retryAfterSeconds": 42 }
  }
}