Recuperar uma sessão
Retorna detalhes centrados na sessão solicitada dentro do alcance de uma organização.
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 valido",
"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": "Sesion no encontrada",
"code": "not_found"
}
}{
"error": {
"message": "Error interno del servidor",
"code": "internal_error"
}
}Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parâmetros de caminho
Identificador da organização.
24^[0-9a-f]{24}$Identificador da sessão.
36^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$Resposta
Detalhes da sessão recuperados corretamente.
Identificador da sessão.
36^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$Conta de usuário para a sessão.
Tipo de sessão.
vdi_desktop, application, sdi_desktop, device Identificador de sessão do Windows.
Estado de conexão da sessão.
unknown, connected, disconnected, terminated, preparing_session, active, reconnecting, non_broker_session, other, pending Marca de tempo de início da sessão.
Indica se a sessão está conectada atualmente.
Identificador atual da sessão de conexão.
Nome atual do data center.
String de marca de tempo da última conexão.
Duração do início da sessão.
Chave de sessão.
36^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$Indica se a execução do analisador foi concluída.
Estado da sessão.
empty, active_notifications, active_notifications_ack_accepted, active_notifications_ack_pending Tipo de plataforma.
windows, mac, linux, android, chrome_os, unknown Uso atual de CPU.
Uso atual de RAM em gigabytes.
Uso atual de RTT.
Uso atual de UID.
Uso atual de RAM.
Porcentagem atual de uso de RAM.
Número de alertas de usuário.
Número de alertas de Workspace.
Identificador MongoDB (_id) do Workspace relacionado com a sessão, resolvido a partir da relação de sessão.
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 valido",
"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": "Sesion no encontrada",
"code": "not_found"
}
}{
"error": {
"message": "Error interno del servidor",
"code": "internal_error"
}
}