快速入門

建立 API 金鑰

前往 API 金鑰頁面並建立新金鑰。選擇所需的範圍－一鍵式「唯讀」預設（包含 metrics:read）是 AI/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 }