REST API 參考
跨 19 資源的 71 端點。 SocialHub v2 REST API 可讓您管理商店、忠誠會員、積分、優惠券、捕獲、大使計畫和追蹤。除非另有說明，否則所有端點都需要 Authorization: Bearer fl_live_…。
https://flash.socialhub.ai/api/v2此參考鏡像了即時 API。 它是按資源分組的端點目錄的靜態快照。如需查看始終保持最新且機器可讀的合約（參數、請求體、回應模式），請參閱 OpenAPI JSON →
使用 Bearer 金鑰進行身份驗證
每個請求都會使用 SocialHub API 金鑰 (fl_live_…) 進行身份驗證，該金鑰以 Bearer 令牌的形式發送。金鑰的作用域限定於您的團隊和每個工具—您可以在 SocialHub 帳戶中建立和管理它們。
curl https://flash.socialhub.ai/api/v2/members \
-H "Authorization: Bearer fl_live_your_key_here"不想讓明文金鑰出現在 shell 歷史記錄中？您可以將其匯出為 FLASH_API_KEY 並引用環境變數。
將金鑰標記為 測試金鑰，即可在同一基礎 URL 的沙箱環境中建置測試環境－無需單獨的環境或憑證。使用該金鑰寫入的資料（會員、訂單、優惠券）將被標記並從您的實際清單和儀表板中隱藏；測試會員不會被實際聯繫（行銷郵件、簡訊和推播通知均會被封鎖），測試優惠券也不會兌換任何實際價值；只需一個 POST /api/v2/test-data/purge 即可清除所有資料。您可以隨意進行實驗，然後重設。
端點
跨 19 資源組的 71 端點。每個端點包含方法、路徑和一行摘要－完整的參數和架構詳情位於 OpenAPI JSON 中。
CWM 預測
4 端點sCWM's 單一最終下一事件分配， TimesFM 2.5 需求預測和租戶私有融合窗口。下一步行為要求 predictions:read趨勢/視窗也需要 metrics:read下一事件機率未經校準，且取決於支援的目標；融合視窗仍然存在。 null 直到經過訓練和驗證。
/api/v2/cwm/capabilities/api/v2/cwm/members/{id}/next-behaviors/api/v2/cwm/trends/api/v2/cwm/members/{id}/purchase-windows門市
4 端點s商店管理
/api/v2/stores/api/v2/stores/{id}/api/v2/stores/api/v2/stores/{id}會員
12 端點s會員管理
/api/v2/members/api/v2/members/api/v2/members/batch/api/v2/members/{id}/api/v2/members/{id}/api/v2/members/{id}/points/api/v2/members/{id}/points/api/v2/members/{id}/tier/api/v2/members/{id}/coupons/api/v2/members/{id}/receipts/api/v2/members/{id}/profile/api/v2/members/{id}/redeem-coupon訂單
4 端點s訂單匯入 → 自動獎勵積分、退款和對賬
/api/v2/orders/api/v2/orders/api/v2/orders/batch/api/v2/orders/{externalOrderId}/refund產品目錄
5 端點s產品目錄 (PIM)－產品、變體、類別、品牌；通用 ERP/Shopify 導入
/api/v2/products/api/v2/products/{id}/api/v2/categories/api/v2/brands/api/v2/catalog/import自訂字段
2 端點s讀取租戶定義的任何實體（會員/商店/產品/優惠券池/訂單）的自訂欄位。唯讀；設計上不涉及個人識別資訊 (PII)。權限範圍：custom_fields:read。
/api/v2/custom-fields/api/v2/custom-fields/values捕獲
1 端點擷取記錄
/api/v2/captures優惠券
4 端點s優惠券池、代碼和兌換
/api/v2/coupons/api/v2/coupons/pools/api/v2/coupons/issue/api/v2/coupons/{id}/redeem大使計劃
3 端點s大使計畫 — 候選人、投資報酬率報告和聯盟代碼
/api/v2/ambassador/candidates/api/v2/ambassador/metrics/api/v2/ambassador/members/{id}/issue-code追蹤
2 端點s頁面訪問/行為分析和事件採集
/api/v2/tracking/stats/api/v2/tracking/eventsAPI 關鍵訊息
3 端點sAPI 金鑰管理
/api/v2/api-keys/api/v2/api-keys/api/v2/api-keys/{id}授權
7 端點s身份驗證和用戶個人資料
/api/v2/auth/register/api/v2/auth/login/api/v2/auth/profile/api/v2/auth/profile/api/v2/auth/change-password/api/v2/auth/forgot-password/api/v2/auth/reset-password細分市場
5 端點s受眾細分 — 用於定向廣告活動的結構化條件。
/api/v2/segments/api/v2/segments/api/v2/segments/{id}/api/v2/segments/{id}/api/v2/segments/{id}行銷活動
3 端點s行銷活動－列出並建立草稿（不會寄出；由人工審核後發送）
/api/v2/campaigns/api/v2/campaigns/api/v2/campaigns/{id}自動化
2 端點s自動化 - 列出事件觸發的流程並暫停/恢復它們
/api/v2/automations/api/v2/automations/{id}交易型
1 端點事務性發送 — 您的系統觸發向單一收件者發送由使用者明確啟用事務性用途（訂單確認、收據）的行銷活動。 API 永遠不會創建內容；始終遵守送達率抑制；傳遞 idempotency_key 以確保重試安全
/api/v2/transactional/send進口
4 端點s非同步批次匯入－上傳 CSV/JSONL 會員/訂單檔案並輪詢作業（無 100 行上限）
/api/v2/members/import/api/v2/members/import/{id}/api/v2/orders/import/api/v2/orders/import/{id}測試數據
1 端點沙盒測試模式資料 — 清除測試金鑰所建立的所有內容
/api/v2/test-data/purge預測性設定檔欄位和更聰明的推薦
兩項升級將融入現有端點－沒有新的公共接口，現有建議端點的回應結構保持不變。
GET /api/v2/members/{id}/profile個人資料總結現在包含 預測欄位，這些欄位會在團隊資料支援匹配時計算得出：
- 預計下次下單日期－基於會員本身購買間隔（需至少購買 3 次）的 Gamma 擬合，傳回間隔統計資料與信賴度指標。
- 郵件點擊傾向 — 基於團隊 L2 正規化邏輯
P(click)來自個人資料的總互動功能。
兩個欄位都位於誠信門下方的 null 之下－絕非猜測。 消費者必須處理null。
Recommendations (public embed + v2)共同購買分數已升級為餘弦歸一化商品相似度，因此配對強度不再受暢銷商品主導：
score = co_count / sqrt(buyers(A) × buyers(B)) # pairs need ≥2 shared buyers
# raw co_count still stored新的每日 作業按團隊運行（支持度/置信度/提升度；MIN_PAIR_ORDERS=3、MIN_CONFIDENCE=0.05、每個前提詞的前 25 條提升度規則），並提供交叉銷售建議。現有整合繼續按原樣運作——響應結構保持不變。