Ottieni Log Applicazione

GET

apps

{app_id}

logs

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/logs \
  --header 'Authorization: <authorization>'

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

fetch('https://api.squarecloud.app/v2/apps/{app_id}/logs', 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/apps/{app_id}/logs",
  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/apps/{app_id}/logs"

	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/apps/{app_id}/logs")

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": {
        "logs": "Working!"
    }
}

Questo endpoint è soggetto a un rigido limite di frequenza. Superare uno qualsiasi dei limiti restituisce 429 Too Many Requests:

1 richiesta ogni 5 secondi per utente, per applicazione.
20 richieste ogni 10 secondi per utente su tutte le applicazioni, seguite da un breve cooldown.

Quando ricevi un 429, interrompi il polling di quella applicazione e attendi la fine del cooldown prima di riprovare.

Usa questo endpoint solo per uno snapshot puntuale dei log (apertura della scheda log o aggiornamento manuale). Per log continui e in tempo reale, usa l’endpoint Log in tempo reale (SSE), che trasmette i log in tempo reale senza raggiungere questo limite di frequenza.

string

obbligatorio

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

Richiede una chiave API con lo scope apps:read. Questo endpoint recupera il buffer stdout/stderr più recente dell’applicazione direttamente dal cluster: è uno snapshot puntuale, non uno stream. stdout e stderr vengono restituiti concatenati nell’ordine in cui sono stati scritti, senza distinzione per riga tra i due, a differenza dell’evento Log in tempo reale, che antepone a ogni riga il proprio identificatore di stream. Usalo quando ti serve un’occhiata puntuale all’output recente, ad esempio per popolare la scheda log al caricamento della pagina o dopo un pulsante di aggiornamento manuale. Restituisce 404 quando l’applicazione è offline, non è mai stata distribuita, oppure il cluster restituisce un errore temporaneo. I membri del workspace con accesso all’applicazione possono chiamarlo allo stesso modo del proprietario.

Parametri

string

obbligatorio

L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.

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

Gli ultimi log dell’applicazione.

{
    "status": "success",
    "response": {
        "logs": "Working!"
    }
}

Errori comuni

Codice	HTTP	Significato
`LOGS_UNAVAILABLE`	404	Impossibile restituire i log: l’applicazione è offline, non è mai stata distribuita o si è verificato un errore temporaneo. Riprova a breve.

Vedi anche

CLI: squarecloud app logs
SDK: api.apps.logs() (JavaScript), client.apps.logs() (Python), c.Apps.Logs() (Go)

Ottieni Log Applicazione

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/logs \
  --header 'Authorization: <authorization>'

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

fetch('https://api.squarecloud.app/v2/apps/{app_id}/logs', 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/apps/{app_id}/logs",
  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/apps/{app_id}/logs"

	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/apps/{app_id}/logs")

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": {
        "logs": "Working!"
    }
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Ottieni Log Applicazione

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche