Démarrage rapide

Créer une clé API

Allez à API Accédez à la page Clés et créez une nouvelle clé. Choisissez les étendues dont vous avez besoin : le préréglage « Lecture seule » accessible en un clic (incluant metrics:read) est le point de départ le plus sûr pour l'IA/Claude Utilisez cette méthode ; n’ajoutez des autorisations d’écriture que lorsque cela est nécessaire. Copiez la clé immédiatement ; elle n’est affichée qu’une seule fois.

Passez votre premier appel API

Utilisez la clé pour lister vos boutiques. Remplacez l'espace réservé par votre clé API.

curl -X GET https://flash.socialhub.ai/api/v2/stores \
  -H "Authorization: Bearer fl_live_your_key_here" \
  -H "Content-Type: application/json"

# Expected response:
# { "stores": [...], "total": 2 }

Interroger un membre

Récupérer la liste des membres du programme de fidélité. Ajouter des paramètres de requête pour filtrer par statut ou paginer les résultats.

curl -X GET "https://flash.socialhub.ai/api/v2/members?status=active&limit=5" \
  -H "Authorization: Bearer fl_live_your_key_here"

# Expected response:
# {
#   "members": [
#     { "id": "m_abc123", "name": "Alice", "status": "active", "points_balance": 1200 }
#   ],
#   "total": 42
# }

Points attribués

Utilisez une requête POST pour attribuer des points de fidélité à un membre. La réponse inclut le nouveau solde.

curl -X POST https://flash.socialhub.ai/api/v2/members/m_abc123/points \
  -H "Authorization: Bearer fl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "description": "Welcome bonus"
  }'

# Expected response:
# { "transactionId": "txn_xyz", "balance": 1700 }