API SecurFyre — abierta, documentada, con sandbox

1 · Empieza en 5 minutos

El flujo típico es: signup → login → token JWT → llamadas autenticadas con Authorization: Bearer ….

# 1. Signup nuevo tenant (sin auth)
curl -X POST https://api.securfyre.com/onboarding/signup \
  -H "Content-Type: application/json" \
  -d '{
    "tenantName": "Mi Mantenedora SL",
    "tenantCif":  "B12345678",
    "adminEmail": "[email protected]",
    "adminName":  "Juan García",
    "adminPassword": "ContraseñaSegura!2026"
  }'

# 2. Login y obtener JWT
curl -X POST https://api.securfyre.com/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"ContraseñaSegura!2026"}'

# Devuelve: { "accessToken": "eyJ...", "refreshToken": "...", "tokenType": "Bearer", "expiresIn": 900 }

# 3. Listar clientes del tenant (autenticado)
curl https://api.securfyre.com/customers \
  -H "Authorization: Bearer \$ACCESS_TOKEN"

# 4. Crear orden de trabajo
curl -X POST https://api.securfyre.com/workorders \
  -H "Authorization: Bearer \$ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "<customer_id>",
    "installationId": "<installation_id>",
    "code": "OT-2026-0123",
    "scheduledFor": "2026-06-01T09:00:00Z"
  }'

2 · Webhooks

Configura webhooks desde el dashboard (Administración → Webhooks) o vía POST /webhooks. SecurFyre firma el body con HMAC-SHA256 y lo envía en X-SecurFyre-Signature. Eventos disponibles:

3 · SDK

JavaScript + Python SDKs disponibles próximamente. Mientras tanto, usa el OpenAPI client generator de tu lenguaje favorito con el spec en https://api.securfyre.com/developers/openapi.json.

# JavaScript / TypeScript con openapi-typescript-codegen
npx openapi-typescript https://api.securfyre.com/developers/openapi.json -o securfyre-sdk.ts

# Python con openapi-python-client
openapi-python-client generate --url https://api.securfyre.com/developers/openapi.json

4 · Documentación interactiva

Swagger UI completo con "try it out", esquemas de respuesta y ejemplos para cada endpoint:

https://api.securfyre.com/api/docs →

5 · Únete al ecosistema

¿Estás integrando SecurFyre con tu ERP, contabilidad o herramienta propia? Cuéntanoslo: te ayudamos con el onboarding técnico, podemos colaborar en la documentación de tu connector y, si tiene sentido, listarte en el directorio público.

[email protected]