Uyumluluk ve Onay API Canlı

Ekibinizin yayınladığı üye gizlilik/uyumluluk bildirimini okuyun ve yönetilen bir v2 REST API üzerinden üye başına onayı doğrulayın. Mağazanız, uygulamanız, veri ambarınız veya arka ofisiniz mevcut bildirimi alabilir, sürüm geçmişini inceleyebilir ve kapsamlı, denetlenmiş anahtarlarla bir üyenin hangi sürümü kabul ettiğini tam olarak doğrulayabilir.

Bizimle konuşun Ürün genel bakışı →

Kimlik Doğrulama ve Kapsamlar

Tüm uç noktalar Flash API ana bilgisayarındadır ve sunucu tarafında bir API anahtar (Bearer) ile kimlik doğrulaması yapar. Ekip her zaman anahtardan türetilir - asla istekte gönderilmez. İki salt okunur kapsam erişimi kontrol eder:

privacy:read — ifade: mevcut sürüm, geçmiş ve belirli bir sürüm.
consent:read — üyenin izin kayıtları (sürüm, kapsamlar, durum, zaman).

# 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"

Açıklamayı okuyun

Sadece yayınlanmış ve arşivlenmiş sürümler — taslaklar asla ifşa edilmez ve içerik API'dan ayrılmadan önce temizlenir (dahili inceleme işaretleri kaldırılır).

GET https://flash.socialhub.ai/api/v2/privacy/current          # scope: privacy:read

# 200 — the current published statement (sanitized), or { "data": null } if none published.
{
  "data": {
    "id": "pol_…",
    "version": "v3",
    "versionSeq": 3,
    "status": "published",
    "locale": "en",
    "changeType": "material",
    "changeSummary": "Updated data-retention section",
    "effectiveAt": "2026-02-01T00:00:00.000Z",
    "contentHash": "…sha256…",
    "content": { "sections": [ { "key": "intro", "title": "…", "body": "…" } ] }
  }
}

GET https://flash.socialhub.ai/api/v2/privacy/policies         # scope: privacy:read

# 200 — version history, newest first (metadata only; published & archived — never drafts).
{
  "data": [
    { "id": "pol_3", "version": "v3", "versionSeq": 3, "status": "published",
      "changeType": "material", "effectiveAt": "2026-02-01T00:00:00.000Z", "contentHash": "…" },
    { "id": "pol_2", "version": "v2", "versionSeq": 2, "status": "archived",
      "changeType": "minor", "effectiveAt": "2026-01-01T00:00:00.000Z", "contentHash": "…" }
  ],
  "total": 2
}

GET https://flash.socialhub.ai/api/v2/privacy/policies/{id}    # one version, full sanitized content (404 for a draft id)

Onayı doğrula

Bir üyenin hangi bildirim sürümüne ve kapsamlarına onay verdiğini tam olarak doğrulayın. Kayıtlar yalnızca ekleme yapılabilir kanıtlardır ve bir üyenin silinmesinden sonra da geçerliliğini korur; API, ham IP veya kullanıcı aracısı olmadan (kişisel bilgilerin en aza indirilmesi) doğrulamanız gerekenleri döndürür.

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": [] }.

Garantiler

Kiracıya özel

teamId şuradan geliyor API Anahtar; başka bir takımın kimliği 404 hatasına yol açıyor. Uç noktalar anahtar başına hız sınırlamasına tabidir.

Taslaklar asla sızdırılmaz

Yalnızca yayınlanmış/arşivlenmiş sürümler sunulur, temizlenir — devam eden çalışma taslakları ve dahili işaretleyiciler içeride kalır.

Rıza ifadeye bağlı

Her kayıt number sürümünü ve bir içerik karmasını taşır, bu nedenle "v3" her zaman aynı kelimeleri ifade eder.

Varsayılan olarak minimal

Onay kayıtları ham IP/kullanıcı aracısını içermez — gözetim verileri değil, doğrulama kanıtı alırsınız.

Makine tarafından okunabilir referans: uç noktalar https://flash.socialhub.ai/api/v2/openapi.json adresindeki v2 OpenAPI spesifikasyonundadır (Privacy etiketi).

Onayın ötesinde: konu abonelikleri, gönderim sırasında uygulanır

Rıza yasal kapıdır; konu abonelikleri, üyenin hangipazarlamayı istediğiyle ilgili daha ayrıntılı bir seçimidir. Bir üye, portalın gizlilik alanından bireysel konuları (promosyon, haber bülteni, sadakat, ürün duyuruları) kapatabilir ve geri kalanını saklayabilir. Bu bir vazgeçme modelidir (kayıt yok = abone olundu) ve sunucu tarafında uygulanır: her kampanya bir konu taşır ve gönderme kapısı, üye bu konuyu kapattığında iletişim politikası sıklık sınırı ve sessiz saatlerin yanı sıra bir mesajı bastırır. İşlemsel mesajlar hiçbir zaman etkilenmez. Üyeler bunu kendileri yönetir; portal bunu bir tüketici oturumu uç noktası (/api/member/topic-subscriptions) üzerinden okur ve yazar, dolayısıyla hiçbir yönetici API anahtarı dahil edilmez.