Subir Aplicación - Square Cloud

curl --request POST \
  --url https://api.squarecloud.app/v2/apps \
  --header 'Authorization: YOUR_API_KEY' \
  --form 'file=@./application.zip'

import fs from 'node:fs';

const form = new FormData();
form.append('file', new Blob([fs.readFileSync('./application.zip')]), 'application.zip');

const response = await fetch('https://api.squarecloud.app/v2/apps', {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
  body: form,
});

import requests

with open('application.zip', 'rb') as f:
    response = requests.post(
        'https://api.squarecloud.app/v2/apps',
        headers={'Authorization': 'YOUR_API_KEY'},
        files={'file': ('application.zip', f, 'application/zip')},
    )

{
    "status": "success",
    "response": {
        "id": "945f574e6cc14ea6818f91d7d56de101",
        "name": "Estrelinha Legal",
        "description": "Nossa, fui enviada na velocidade da luz! ✨",
        "domain": null,
        "ram": 1024,
        "cpu": 6,
        "language": {
            "name": "JavaScript",
            "version": "recommended"
        }
    }
}

string

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Upload crea una aplicación totalmente nueva a partir de un archivo zip: detecta el runtime y la versión, aprovisiona un contenedor en el cluster que actualmente tenga el menor uso de RAM, y lo inicia. Úsalo para un primer deploy; para enviar un cambio a una aplicación que ya existe, usa Enviar Commit a la Aplicación en su lugar, que es más rápido porque no vuelve a aprovisionar el contenedor. Quien realiza la llamada necesita al menos 256 MB de memoria disponible en su plan antes de que se acepte la subida, y el zip tiene un límite de 100 MB. Los campos de la respuesta dependen de tu squarecloud.config: description y subdomain solo están presentes cuando se configuran allí, y language reporta el runtime y la versión detectados. Las solicitudes tienen un límite de 1 subida cada 3 segundos por usuario. Una vez que la aplicación esté en ejecución, gestiónala con Iniciar, Detener y Reiniciar, y consulta su estado con Obtener Estado de la Aplicación.

Parámetros

file

requerido

La aplicación que se va a subir debe estar comprimida en un archivo zip (.zip) y el Content-Type debe ser multipart/form-data.

Respuesta

string

Indica si la llamada fue exitosa. success si fue exitosa, error si no.

object

El contenido de la respuesta.

Mostrar Alternar objeto

string

El ID de la aplicación subida.

string

El nombre de la aplicación subida.

string

La descripción de la aplicación subida.

string

El subdominio de la aplicación subida (null si no aplica).

number

El uso de RAM de la aplicación subida en MB.

number

El uso de CPU de la aplicación subida.

object

Mostrar Alternar objeto

string

El lenguaje de programación de la aplicación subida.

string

La versión recomendada del lenguaje de programación.

string

El cluster donde la aplicación está alojada en la nube.

curl --request POST \
  --url https://api.squarecloud.app/v2/apps \
  --header 'Authorization: YOUR_API_KEY' \
  --form 'file=@./application.zip'

import fs from 'node:fs';

const form = new FormData();
form.append('file', new Blob([fs.readFileSync('./application.zip')]), 'application.zip');

const response = await fetch('https://api.squarecloud.app/v2/apps', {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
  body: form,
});

import requests

with open('application.zip', 'rb') as f:
    response = requests.post(
        'https://api.squarecloud.app/v2/apps',
        headers={'Authorization': 'YOUR_API_KEY'},
        files={'file': ('application.zip', f, 'application/zip')},
    )

{
    "status": "success",
    "response": {
        "id": "945f574e6cc14ea6818f91d7d56de101",
        "name": "Estrelinha Legal",
        "description": "Nossa, fui enviada na velocidade da luz! ✨",
        "domain": null,
        "ram": 1024,
        "cpu": 6,
        "language": {
            "name": "JavaScript",
            "version": "recommended"
        }
    }
}

Errores comunes

Código	HTTP	Significado
`INVALID_CONTENT_TYPE`	415	El cuerpo de la solicitud no es `multipart/form-data`.
`INVALID_FILE`	400	No se encontró ningún campo de archivo en los datos del formulario.
`INVALID_FILENAME`	400	El nombre del archivo contiene separadores de ruta, `..` o caracteres de control.
`INSUFFICIENT_MEMORY`	400	La cuenta tiene menos de 256 MB de memoria disponible en su plan.
`UPLOAD_ABORTED`	400	El cliente se desconectó antes de que terminara la subida.
`STORAGE_UPLOAD_FAILED`	400	El archivo no se pudo subir al almacenamiento; vuelve a intentarlo más tarde.
`CLUSTER_SELECTION_FAILED`	400	No había ningún cluster disponible para alojar la aplicación.
`EMPTY_RESPONSE`	400	El cluster no devolvió una respuesta utilizable.
`UPLOAD_FAILED`	400	Ocurrió un error inesperado al procesar la subida.
`FILE_TOO_LARGE`	413	La subida superó el límite de tamaño de 100 MB.
`CLUSTER_MAINTENANCE_TRY_LATER`	503	El aprovisionamiento de aplicaciones no está disponible temporalmente por mantenimiento.

Estado de Todas las AplicacionesRecopila información de estado sobre todas tus aplicaciones en tiempo real. Tiene un límite de 15 solicitudes cada 60 segundos.

curl --request POST \
  --url https://api.squarecloud.app/v2/apps \
  --header 'Authorization: YOUR_API_KEY' \
  --form 'file=@./application.zip'

import fs from 'node:fs';

const form = new FormData();
form.append('file', new Blob([fs.readFileSync('./application.zip')]), 'application.zip');

const response = await fetch('https://api.squarecloud.app/v2/apps', {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
  body: form,
});

import requests

with open('application.zip', 'rb') as f:
    response = requests.post(
        'https://api.squarecloud.app/v2/apps',
        headers={'Authorization': 'YOUR_API_KEY'},
        files={'file': ('application.zip', f, 'application/zip')},
    )

{
    "status": "success",
    "response": {
        "id": "945f574e6cc14ea6818f91d7d56de101",
        "name": "Estrelinha Legal",
        "description": "Nossa, fui enviada na velocidade da luz! ✨",
        "domain": null,
        "ram": 1024,
        "cpu": 6,
        "language": {
            "name": "JavaScript",
            "version": "recommended"
        }
    }
}

​Parámetros

​Respuesta

​Errores comunes

Parámetros

Respuesta

Errores comunes