クイックスタート

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 }