Schnellstart

Einen API-Schlüssel erstellen

Gehen Sie zur Seite „API-Schlüssel“ und erstellen Sie einen neuen Schlüssel. Wählen Sie die Bereiche aus, die Sie benötigen – die Ein-Klick-Voreinstellung „Schreibgeschützt“ (einschließlich metrics:read) ist der sicherste Einstieg für die Verwendung von AI/Claude; Fügen Sie Schreibbereiche nur dann hinzu, wenn Sie sie benötigen. Kopieren Sie den Schlüssel sofort – er wird nur einmal angezeigt.

Tätigen Sie Ihren ersten API-Anruf

Verwenden Sie den Schlüssel, um Ihre Shops aufzulisten. Ersetzen Sie den Platzhalter durch Ihren tatsächlichen API-Schlüssel.

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 }

Mitgliederanfrage

Rufen Sie die Liste der Treuekunden ab. Fügen Sie Abfrageparameter hinzu, um nach Status zu filtern oder die Ergebnisse zu paginieren.

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

Prämienpunkte

Verwenden Sie eine POST-Anfrage, um einem Mitglied Treuepunkte gutzuschreiben. Die Antwort enthält den neuen Punktestand.

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 }