REST API Référence
71 points de terminaison sur 19 ressources. Le SocialHub v2 REST API permet de gérer les magasins, les membres fidélité, les points, les coupons, les captures, le programme Ambassadeur et le suivi. Tous les points de terminaison nécessitent Authorization: Bearer fl_live_…, sauf indication contraire.
https://flash.socialhub.ai/api/v2Cette référence reflète la référence en direct API. Il s'agit d'un instantané statique du catalogue de points de terminaison, regroupé par ressource. Pour le contrat toujours à jour et lisible par machine (paramètres, corps des requêtes, schémas de réponse), voir OpenAPI JSON →
Authentification avec une clé Bearer
Chaque requête s'authentifie avec une clé SocialHub API (fl_live_…) envoyée sous forme de jeton Bearer. Les clés sont attribuées à votre équipe et à chaque outil ; créez-les et gérez-les dans votre compte SocialHub.
curl https://flash.socialhub.ai/api/v2/members \
-H "Authorization: Bearer fl_live_your_key_here"Vous préférez ne pas inclure la clé en clair dans l'historique de votre terminal ? Exportez-la au format FLASH_API_KEY et référencez la variable d'environnement.
Marquez une clé comme clé de test pour effectuer des tests dans un environnement de test (sandbox) sur la même URL de base — sans environnement ni identifiants supplémentaires. Les données enregistrées avec cette clé (membres, commandes, coupons) sont marquées et masquées dans vos listes et tableaux de bord en production ; un membre de test n'est jamais contacté (les e-mails, SMS et notifications push marketing sont désactivés) et un coupon de test n'est jamais utilisé ; une simple POST /api/v2/test-data/purge efface tout. Expérimentez librement, puis réinitialisez.
Points de terminaison
71 Points de terminaison répartis dans les groupes de ressources 19. Méthode, chemin et résumé (une ligne) pour chacun ; les paramètres complets et le schéma détaillé se trouvent dans le JSON OpenAPI.
CWM Prévisions
4 point de terminaisonsCWMla distribution finale unique du prochain événement, TimesFM 2,5 prévisions de la demande et fenêtres de fusion privées locataires. Les comportements futurs nécessitent predictions:read; les tendances/fenêtres nécessitent également metrics:readLes probabilités des événements suivants ne sont pas calibrées et dépendent des cibles prises en charge ; les fenêtres de fusion restent null jusqu'à ce qu'ils soient formés et validés.
/api/v2/cwm/capabilities/api/v2/cwm/members/{id}/next-behaviors/api/v2/cwm/trends/api/v2/cwm/members/{id}/purchase-windowsMagasins
4 point de terminaisonsGestion de la Boutique
/api/v2/stores/api/v2/stores/{id}/api/v2/stores/api/v2/stores/{id}Membres
12 point de terminaisonsGestion des membres du programme de fidélité
/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-couponCommandes
4 point de terminaisonsIngestion des commandes → attribution automatique de points, remboursements et rapprochement
/api/v2/orders/api/v2/orders/api/v2/orders/batch/api/v2/orders/{externalOrderId}/refundCatalogue
5 point de terminaisonsCatalogue de produits (PIM) — produits, variantes, catégories, marques ; import ERP générique/Shopify
/api/v2/products/api/v2/products/{id}/api/v2/categories/api/v2/brands/api/v2/catalog/importChamps personnalisés
2 point de terminaisonsAccès aux champs personnalisés définis par le locataire pour toute entité (membre, magasin, produit, pool de coupons, commande). Lecture seule ; contenu non personnel. Portée : custom_fields:read.
/api/v2/custom-fields/api/v2/custom-fields/valuesCaptures
1 point de terminaisonEnregistrements de capture
/api/v2/capturesCoupons
4 point de terminaisonsGestion des coupons, codes et utilisation
/api/v2/coupons/api/v2/coupons/pools/api/v2/coupons/issue/api/v2/coupons/{id}/redeemAmbassadeur
3 point de terminaisonsProgramme Ambassadeur — candidats, rapport sur le retour sur investissement et codes d’affiliation
/api/v2/ambassador/candidates/api/v2/ambassador/metrics/api/v2/ambassador/members/{id}/issue-codeSuivi
2 point de terminaisonsAnalyse des visites de pages et des comportements, et collecte d'événements
/api/v2/tracking/stats/api/v2/tracking/eventsClés de API
3 point de terminaisonsAPI Gestion des clés
/api/v2/api-keys/api/v2/api-keys/api/v2/api-keys/{id}Authentification
7 point de terminaisonsAuthentification et profil utilisateur
/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-passwordSegments
5 point de terminaisonsSegments d'audience — conditions structurées utilisées pour cibler les campagnes
/api/v2/segments/api/v2/segments/api/v2/segments/{id}/api/v2/segments/{id}/api/v2/segments/{id}Campagnes
3 point de terminaisonsCampagnes — liste et création de brouillons (jamais envoyés ; un humain les vérifie et les envoie).
/api/v2/campaigns/api/v2/campaigns/api/v2/campaigns/{id}Automatisations
2 point de terminaisonsAutomatisations : répertoriez les flux déclenchés par des événements et mettez-les en pause/reprenez-les
/api/v2/automations/api/v2/automations/{id}Transactionnel
1 point de terminaisonEnvoi transactionnel — votre système déclenche l'envoi d'une campagne à un seul destinataire, autorisé explicitement par un utilisateur à un usage transactionnel (confirmations de commande, reçus). API Ne jamais créer de contenu ; la suppression de la délivrabilité est toujours respectée ; passer idempotency_key pour sécuriser les nouvelles tentatives
/api/v2/transactional/sendImportations
4 point de terminaisonsImportation groupée asynchrone : importez un fichier CSV/JSONL de membres/commandes et interrogez la tâche (pas de limite de 100 lignes)
/api/v2/members/import/api/v2/members/import/{id}/api/v2/orders/import/api/v2/orders/import/{id}Données de test
1 point de terminaisonDonnées du mode test sandbox : suppression de toutes les données créées par une clé de test.
/api/v2/test-data/purgeChamps de profil prédictifs et recommandations plus pertinentes
Deux mises à jour sont intégrées aux points de terminaison existants ; aucune nouvelle interface publique n’est créée et les formats de réponse des points de terminaison de recommandation existants restent inchangés.
GET /api/v2/members/{id}/profileLes profils agrégés incluent désormais des champs prédictifs , calculés lorsque les données de l'équipe permettent une adéquation :
- Date prévue de la prochaine commande — une distribution gamma personnalisée, basée sur les intervalles d'achat du membre (nécessite au moins 3 achats), est renvoyée avec les statistiques des intervalles et un indicateur de confiance.
- Propension à cliquer sur les e-mails : une métrique logistique L2 régularisée par équipe
P(click)issue des fonctionnalités d’engagement cumulées du profil.
Les deux champs sont null en dessous des barrières d'honnêteté ; aucune supposition n'est possible. Les consommateurs doivent gérer null.
Recommendations (public embed + v2)Le système de notation des achats conjoints est mis à jour et utilise désormais la similarité article-article normalisée par cosinus , ce qui signifie que la force d'une paire n'est plus dominée par les meilleures ventes :
score = co_count / sqrt(buyers(A) × buyers(B)) # pairs need ≥2 shared buyers
# raw co_count still storedUne nouvelle tâche nocturne d'extraction de règles d'association est exécutée par équipe (support / confiance / gain ; MIN_PAIR_ORDERS=3, MIN_CONFIDENCE=0.05, 25 meilleures règles par antécédent par gain) et génère des suggestions de vente croisée. Les intégrations existantes continuent de fonctionner normalement — la structure des réponses reste inchangée.