Pular para o conteúdo principal
POST
/
v2
/
apps
/
{app_id}
/
snapshots
Criar Snapshot
curl --request POST \
  --url https://api.squarecloud.app/v2/apps/{app_id}/snapshots \
  --header 'Authorization: <authorization>'
{
    "status": "success",
    "response": {
        "url": "https://snapshots.squarecloud.app/applications/23457145698959364/a23d130fcc9ddaf2d288ae9599a4292c32.zip?AWSAccessKeyId=i06Xdad2dRD74Pm8Xly&Expires=1753081182&Signature=riWPedawcsouRAPGU5n3kGHnWoOuw%3D",
        "key": "AWSAccessKeyId=i06Xdad2dRD74Pm8Xly&Expires=1753081182&Signature=riWPedawcsouRAPGU5n3kGHnWoOuw%3D"
    }
}

Documentation Index

Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt

Use this file to discover all available pages before exploring further.

Cada conta pode executar até (RAM / 256) * 2 snapshots a cada 24 horas.
​
Authorization
string
obrigatório
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.
​
app_id
string
obrigatório
O ID da aplicação. Você pode encontrá-lo na URL do painel da sua aplicação.

​
Response

​
status
string
Indica se a chamada foi bem-sucedida. success se bem-sucedida, error se não.
​
response
object
O conteúdo da resposta.

​
Erros

Uma requisição de snapshot pode ser rejeitada com 429 Too Many Requests. Use o campo code para distinguir os dois casos:
​
KEEP_CALM
429
Cooldown de curto prazo — você atingiu o limite por usuário (1 requisição / 5s) ou por aplicação (1 requisição / 60s). Aguarde um instante e tente novamente.
​
DAILY_SNAPSHOTS_LIMIT_REACHED
429
Cota diária atingida — a conta esgotou o limite diário de snapshots do plano ((RAM / 256) × 2 por 24h). A cota é renovada conforme a janela de 24 horas avança; para um limite diário maior, faça upgrade do plano.
{
    "status": "success",
    "response": {
        "url": "https://snapshots.squarecloud.app/applications/23457145698959364/a23d130fcc9ddaf2d288ae9599a4292c32.zip?AWSAccessKeyId=i06Xdad2dRD74Pm8Xly&Expires=1753081182&Signature=riWPedawcsouRAPGU5n3kGHnWoOuw%3D",
        "key": "AWSAccessKeyId=i06Xdad2dRD74Pm8Xly&Expires=1753081182&Signature=riWPedawcsouRAPGU5n3kGHnWoOuw%3D"
    }
}