快速入门

创建 API 密钥

前往 API 在“密钥”页面中创建一个新密钥。选择所需的范围——一键式“只读”预设（包括） metrics:read）是人工智能最安全的起点/Claude 仅在需要时添加写入权限。立即复制密钥——它只会显示一次。

拨打您的第一个API电话

使用此密钥列出您的店铺。请将占位符替换为您实际的 API 密钥。

curl -X GET https://flash.socialhub.ai/api/v2/stores \
  -H "Authorization: Bearer fl_live_your_key_here" \
  -H "Content-Type: application/json"

# Expected response:
# { "stores": [...], "total": 2 }

查询会员

获取会员列表。添加查询参数以按状态筛选或分页显示结果。

curl -X GET "https://flash.socialhub.ai/api/v2/members?status=active&limit=5" \
  -H "Authorization: Bearer fl_live_your_key_here"

# Expected response:
# {
#   "members": [
#     { "id": "m_abc123", "name": "Alice", "status": "active", "points_balance": 1200 }
#   ],
#   "total": 42
# }

奖励积分

使用POST请求向会员授予积分。响应包含新的积分余额。

curl -X POST https://flash.socialhub.ai/api/v2/members/m_abc123/points \
  -H "Authorization: Bearer fl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "description": "Welcome bonus"
  }'

# Expected response:
# { "transactionId": "txn_xyz", "balance": 1700 }