コンプライアンスと同意 API ライブ

認証とスコープ

すべてのエンドポイントはFlash APIホスト上にあり、サーバー側のAPIキー（ベアラーキー）で認証を行います。チームは常にキーから派生し、リクエストには含まれません。2つの読み取り専用スコープでアクセスを制御します。

• privacy:read — ステートメント: 現在のバージョン、履歴、および特定のバージョン。
• consent:read — メンバーの同意記録 (バージョン、スコープ、ステータス、時間)。

# Every call uses a server-side API key (Bearer). teamId is derived from the key,
# never sent in the request. Two read scopes:
#   privacy:read  → the statement (current / history / a version)
#   consent:read  → a member's consent records
curl https://flash.socialhub.ai/api/v2/privacy/current \
  -H "Authorization: Bearer fl_live_your_key_here"

同意の確認

メンバーが同意したステートメントのバージョンとスコープを正確に確認してください。記録は追加のみの証拠であり、メンバーが削除しても存続します。 API は、生の IP やユーザー エージェント (PII の最小化) なしで、検証する必要があるものを返します。

GET https://flash.socialhub.ai/api/v2/members/{id}/consents   # scope: consent:read

# 200 — the member's consent records, newest first. The evidence to VERIFY consent:
# which statement version + scopes, the method, status and time. No raw IP / user-agent.
{
  "data": [
    {
      "id": "con_…",
      "scopes": ["privacy_policy", "marketing_email"],
      "method": "register",
      "status": "active",                 // active | legacy_unverified | withdrawn
      "policyVersion": "v3",
      "policyVersionSeq": 3,
      "policyContentHash": "…sha256…",
      "consentedAt": "2026-02-02T10:30:00.000Z"
    }
  ]
}
# A member of another team (or unknown) → 404. No consents yet → { "data": [] }.