빠른 시작

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 }