Elenca Workspace

GET

workspaces

Elenca Workspace

curl --request GET \
  --url https://api.squarecloud.app/v2/workspaces \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/workspaces', 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.squarecloud.app/v2/workspaces",
  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: <authorization>"
  ],
]);

$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.squarecloud.app/v2/workspaces"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/workspaces")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
    "status": "success",
    "response": [
        {
            "id": "3f9c2a7e5b1d4e8a9c6f0b2d4e6a8c1f",
            "name": "Test",
            "owner": "5354d9742d889d49b20134ba0be09ccc0033be68",
            "members": [
            {
                "name": "Example",
                "id": "5354d9742d889d49b20134ba0be09ccc0033be68",
                "group": "owner",
                "joinedAt": "2025-06-04T20:44:55.934Z"
            }
            ],
            "applications": [],
            "createdAt": "2025-06-04T20:44:55.934Z"
        }
    ]
}

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Richiede una chiave API con lo scope workspaces:manage. Restituisce tutti i workspace in cui l’utente autenticato è proprietario o membro, ciascuno arricchito con il proprio elenco membri (nomi e ruoli) e le applicazioni condivise (nome, RAM, linguaggio, dominio). È il punto di partenza per costruire un selettore di workspace o una dashboard, poiché evita una chiamata a Ottieni workspace per ogni workspace. La risposta è un array vuoto per un utente senza workspace, sia perché ha un piano senza accesso ai workspace sia perché semplicemente non ne ha ancora creato o non si è ancora unito a uno. Per crearne il primo, vedi Crea workspace.

Risposta

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

object

Il contenuto della risposta.

Mostra Mostra oggetto

string

L’ID del workspace: 32 caratteri esadecimali (un UUID v4 senza trattini). I workspace più vecchi hanno un ID esadecimale di 40 caratteri.

string

L’id del proprietario del Workspace.

string

Il nome del Workspace.

object

L’elenco dei membri del workspace. Include sempre il proprietario, con group: "owner".

Mostra Mostra oggetto

string

L’ID dell’utente.

string

Il nome dell’utente. Può essere null, ad esempio quando l’account è stato eliminato.

string

I permessi del membro sulle applicazioni del workspace.

string

Il timestamp di adesione in UTC-0.

object

L’elenco delle applicazioni del workspace.

Mostra Mostra oggetto

string

L’ID dell’applicazione caricata.

string

Il nome dell’applicazione caricata.

number

L’utilizzo di RAM dell’applicazione caricata in MB.

object

Il linguaggio di programmazione dell’applicazione caricata.

string

Il timestamp di creazione in UTC-0.

{
    "status": "success",
    "response": [
        {
            "id": "3f9c2a7e5b1d4e8a9c6f0b2d4e6a8c1f",
            "name": "Test",
            "owner": "5354d9742d889d49b20134ba0be09ccc0033be68",
            "members": [
            {
                "name": "Example",
                "id": "5354d9742d889d49b20134ba0be09ccc0033be68",
                "group": "owner",
                "joinedAt": "2025-06-04T20:44:55.934Z"
            }
            ],
            "applications": [],
            "createdAt": "2025-06-04T20:44:55.934Z"
        }
    ]
}

Errori comuni

Codice	HTTP	Significato
`DATABASE_UNAVAILABLE`	503	Il servizio è brevemente non disponibile. Riprova tra qualche secondo.

Vedi anche

CLI: squarecloud workspace list
SDK: api.workspaces.list() (JavaScript), client.workspaces.list() (Python), c.Workspaces.List() (Go)

Elenca Workspace

curl --request GET \
  --url https://api.squarecloud.app/v2/workspaces \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/workspaces', 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.squarecloud.app/v2/workspaces",
  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: <authorization>"
  ],
]);

$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.squarecloud.app/v2/workspaces"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/workspaces")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
    "status": "success",
    "response": [
        {
            "id": "3f9c2a7e5b1d4e8a9c6f0b2d4e6a8c1f",
            "name": "Test",
            "owner": "5354d9742d889d49b20134ba0be09ccc0033be68",
            "members": [
            {
                "name": "Example",
                "id": "5354d9742d889d49b20134ba0be09ccc0033be68",
                "group": "owner",
                "joinedAt": "2025-06-04T20:44:55.934Z"
            }
            ],
            "applications": [],
            "createdAt": "2025-06-04T20:44:55.934Z"
        }
    ]
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Risposta

Errori comuni

Vedi anche

​Risposta

​Errori comuni

​Vedi anche

Risposta

Errori comuni

Vedi anche