Inicio rápido

Crear una clave API

Ve al API Página de claves y cree una nueva clave. Elija los ámbitos que necesita: el ajuste preestablecido "Solo lectura" de un clic (incluye metrics:read) es el comienzo más seguro para la IA/Claude Utilice permisos de escritura solo cuando los necesite. Copie la clave inmediatamente; solo se muestra una vez.

Haga su primera API llamada

Utilice la clave para enumerar sus tiendas. Reemplace el marcador de posición con su clave API real.

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 }

Consultar a un miembro

Obtenga la lista de miembros del programa de fidelización. Añada parámetros de consulta para filtrar por estado o paginar los resultados.

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

Puntos de premio

Utilice una solicitud POST para otorgar puntos de fidelización a un miembro. La respuesta incluye el nuevo saldo.

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 }