Conformité et consentement API En direct

Consultez la déclaration de confidentialité/conformité publiée par votre équipe et vérifiez le consentement de chaque membre sur une version 2 contrôlée REST API. Votre boutique en ligne, application, entrepôt de données ou système d'administration peut récupérer la déclaration actuelle, consulter son historique des versions et confirmer précisément la version à laquelle un membre a consenti, grâce à des clés d'accès contrôlées et auditées.

Contactez-nous Présentation du produit →

Authentification et périmètres

Tous les points de terminaison se trouvent sur l'hôte Flash API et s'authentifient avec une clé API côté serveur (Bearer). L'équipe est toujours dérivée de la clé et n'est jamais envoyée dans la requête. Deux étendues en lecture seule contrôlent l'accès :

privacy:read — l'état d'avancement : version actuelle, historique et version spécifique.
consent:read — Enregistrements de consentement d'un membre (version, périmètre, statut, date).

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

Lisez la déclaration.

Versions publiées et archivées uniquement : les brouillons ne sont jamais divulgués et le contenu est nettoyé (supprimé des marques de révision interne) avant de quitter API.

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)

Vérifier le consentement

Confirmez précisément la version et le périmètre de la déclaration auxquels un membre a consenti. Les enregistrements constituent une preuve additionnelle et sont conservés même après la suppression du compte d'un membre ; la fonction API renvoie les informations nécessaires à la vérification, sans l'adresse IP brute ni l'agent utilisateur (minimisation des données personnelles).

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

Garanties

Isolation des locataires

teamId provient de la clé API ; l'identifiant d'une autre équipe est résolu en 404. Les points de terminaison sont limités en débit par clé.

Les brouillons ne fuient jamais

Seules les versions publiées/archivées sont diffusées et nettoyées ; les brouillons en cours et les annotations internes restent confidentiels.

Consentement lié à la formulation

Chaque enregistrement contient la version number et un hachage de contenu ; ainsi, « v3 » désigne toujours les mêmes mots.

Configuration minimale par défaut

Les enregistrements de consentement omettent l'adresse IP brute et l'agent utilisateur ; vous obtenez la preuve de vérification, et non des données de surveillance.

Référence lisible par machine : les points de terminaison se trouvent dans la spécification OpenAPI v2 à https://flash.socialhub.ai/api/v2/openapi.json (balise Privacy).

Au-delà du consentement : abonnements aux sujets, appliqués lors de l'envoi.

Le consentement est la condition légale ; les abonnements thématiques représentent le choix plus précis du membre. lequelLe marketing qu'ils souhaitent. Depuis l'espace de confidentialité du portail, un membre peut désactiver des sujets individuels (promotions, newsletters, fidélisation, annonces de produits) tout en conservant les autres. Il s'agit d'un modèle de désabonnement (pas d'enregistrement = abonnement), appliqué côté serveur : chaque campagne est associée à un sujet, et le système bloque l'envoi d'un message lorsque le membre a désactivé ce sujet, en plus de la limite de fréquence de communication et des heures de silence définies par la politique de communication. Les messages transactionnels ne sont jamais affectés. Les membres gèrent eux-mêmes ces paramètres ; le portail les lit et les écrit via un point de terminaison de session client (/api/member/topic-subscriptions), donc pas d'administrateur API Une clé est impliquée.