Recuperar una sesión
Devuelve detalles centrados en la sesión solicitada dentro del alcance de una organización.
curl --request GET \
--url https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "550E8400-E29B-41D4-A716-446655440000",
"user_name": "contoso\\jdoe",
"session_type": "vdi_desktop",
"windows_session_id": 7,
"connection_state": "active",
"start_date": "2026-03-15T08:30:00Z",
"session_status": "active_notifications",
"platform_type": "windows",
"connected": true,
"current_session_id": 41,
"current_dc_name": "dc-eu-01",
"last_connection_time": "2026-03-15T09:45:11Z",
"log_on_duration": 35,
"session_key": "6BA7B810-9DAD-11D1-80B4-00C04FD430C8",
"flexx_analyzer_executed": true,
"cpu_usage": 34.2,
"ram_usage_gb": 3.8,
"rtt_usage": 18.1,
"current_uid_usage": 2.4,
"ram_usage": 3891,
"ram_percentage": 47,
"number_alerts_user": 0,
"number_alerts_vm": 1,
"workspace_id": "64f0c2a1b2d3e4f5060708aa"
}{
"error": {
"message": "Formato de session_id no válido",
"code": "bad_request",
"details": "session_id debe ser un UUID en mayusculas con formato 8-4-4-4-12"
}
}{
"error": {
"message": "No autorizado",
"code": "unauthorized"
}
}{
"error": {
"message": "sesión no encontrada",
"code": "not_found"
}
}{
"error": {
"message": "Error interno del servidor",
"code": "internal_error"
}
}Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parámetros de ruta
Identificador de la organización.
24^[0-9a-f]{24}$Identificador de la sesión.
36^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$Respuesta
Detalles de la sesión recuperados correctamente.
Identificador de la sesión.
36^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$Cuenta de usuario para la sesión.
Tipo de sesión.
vdi_desktop, application, sdi_desktop, device Identificador de sesión de Windows.
Estado de conexión de la sesión.
unknown, connected, disconnected, terminated, preparing_session, active, reconnecting, non_broker_session, other, pending Marca de tiempo de inicio de la sesión.
Indica si la sesión esta conectada actualmente.
Identificador actual de la sesión de conexión.
Nombre actual del centro de datos.
Cadena de marca de tiempo de la última conexión.
Duración de inicio de sesión.
Clave de sesión.
36^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$Indica si la ejecucion del analizador se ha completado.
Estado de la sesión.
empty, active_notifications, active_notifications_ack_accepted, active_notifications_ack_pending Tipo de plataforma.
windows, mac, linux, android, chrome_os, unknown Uso actual de CPU.
Uso actual de RAM en gigabytes.
Uso actual de RTT.
Uso actual de UID.
Uso actual de RAM.
Porcentaje actual de uso de RAM.
Número de alertas de usuario.
Número de alertas de Workspace.
Identificador MongoDB (_id) del Workspace relacionado con la sesión, resuelto a partir de la relación de sesión.
24^[0-9a-f]{24}$curl --request GET \
--url https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flexxible.net/v2/organizations/{organization_id}/sessions/{session_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "550E8400-E29B-41D4-A716-446655440000",
"user_name": "contoso\\jdoe",
"session_type": "vdi_desktop",
"windows_session_id": 7,
"connection_state": "active",
"start_date": "2026-03-15T08:30:00Z",
"session_status": "active_notifications",
"platform_type": "windows",
"connected": true,
"current_session_id": 41,
"current_dc_name": "dc-eu-01",
"last_connection_time": "2026-03-15T09:45:11Z",
"log_on_duration": 35,
"session_key": "6BA7B810-9DAD-11D1-80B4-00C04FD430C8",
"flexx_analyzer_executed": true,
"cpu_usage": 34.2,
"ram_usage_gb": 3.8,
"rtt_usage": 18.1,
"current_uid_usage": 2.4,
"ram_usage": 3891,
"ram_percentage": 47,
"number_alerts_user": 0,
"number_alerts_vm": 1,
"workspace_id": "64f0c2a1b2d3e4f5060708aa"
}{
"error": {
"message": "Formato de session_id no válido",
"code": "bad_request",
"details": "session_id debe ser un UUID en mayusculas con formato 8-4-4-4-12"
}
}{
"error": {
"message": "No autorizado",
"code": "unauthorized"
}
}{
"error": {
"message": "sesión no encontrada",
"code": "not_found"
}
}{
"error": {
"message": "Error interno del servidor",
"code": "internal_error"
}
}