Saltar al contenido principal

Inicio Rápido de la API

Comienza a usar la API de Console en menos de 5 minutos.

Prerrequisitos​

  • Slug de compañía y credenciales de administrador
  • Herramienta para hacer solicitudes HTTP (curl, Postman, o código)
  • (Opcional) jq para formatear respuestas JSON

Paso 1: Autenticarse​

Obtén un token de acceso iniciando sesión:

curl -X POST https://api.console.solucao42.com.br/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "company_slug": "your-company",
    "email": "[email protected]",
    "password": "your-password"
  }'

Respuesta:

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
  "access_token_expires_in": 600,
  "refresh_token_expires_in": 604800,
  "user": {
    "_id": "507f1f77bcf86cd799439011",
    "email": "[email protected]",
    "name": "Admin User"
  }
}
Guarda el Token

Almacena el access_token para las siguientes solicitudes. Expira en 10 minutos.

Paso 2: Haz Tu Primera Llamada a la API​

Obtén la lista de usuarios:

curl https://api.console.solucao42.com.br/v1/users \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Respuesta:

{
  "total": 3,
  "quantity": 3,
  "records": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "email": "[email protected]",
      "name": "Admin User",
      "status": "active"
    }
  ]
}

Paso 3: Invita a un Nuevo Usuario​

curl -X POST https://api.console.solucao42.com.br/v1/users/invite \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "group_ids": ["users-group"]
  }'

Renovación de Token​

Cuando tu access token expire (10 min), renuévalo:

curl -X POST https://api.console.solucao42.com.br/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{
    "refresh_token": "YOUR_REFRESH_TOKEN"
  }'

Devuelve nuevos tokens de acceso y actualización.

Próximos Pasos​

Para Usuarios del Producto

¿Gestionas usuarios a través de la interfaz web? Consulta la Documentación del Producto.