Hobby
Porta l'idea fuori dal localhost e mettila online.
- Fino a 2 vCPU
- Metriche in tempo reale
- Blob Storage
- Rollback con 1 clic
- Square Shield anti-DDoS
A partire da12,49 BRL/mese≈ 2,00 €
Gli SDK ufficiali dell’API di Square Cloud. Fai il deploy, riavvia, leggi i log, modifica file, crea snapshot e imposta domini dai tuoi script, senza dipendenze a runtime.
Quattro pacchetti ufficiali: tre per l’API di Square Cloud e uno per Blob Storage. Ognuno richiede solo il runtime del proprio linguaggio.
@squarecloud/api
Node.js 22+, Deno, Bun e runtime edge
npm install @squarecloud/apisquarecloud-api
Python 3.11+, con client sincroni e asincroni
pip install squarecloud-apigithub.com/squarecloudofc/sdk-api-go/v3
Go 1.22+, con un context in ogni chiamata
go get github.com/squarecloudofc/sdk-api-go/v3@squarecloud/blob
Node.js 20+ e il browser
npm install @squarecloud/blobCrea una chiave API, impostala come variabile d’ambiente SQUARECLOUD_API_KEY ed esegui uno di questi programmi. Ognuno stampa il tuo nome e quante applicazioni la chiave può vedere.
import { SquareCloudAPI } from "@squarecloud/api";const api = new SquareCloudAPI(process.env.SQUARECLOUD_API_KEY);const { user, applications } = await api.account.me();console.log(`Hi ${user.name}, you have ${applications.length} apps`);import osfrom squarecloud import SquareCloudwith SquareCloud(os.environ["SQUARECLOUD_API_KEY"]) as client: me = client.account.me() print(f"Hi {me['user']['name']}, you have {len(me['applications'])} apps")package mainimport ( "context" "fmt" "log" "os" "github.com/squarecloudofc/sdk-api-go/v3")func main() { c := squarecloud.New(os.Getenv("SQUARECLOUD_API_KEY")) me, err := c.Account.Me(context.Background()) if err != nil { log.Fatal(err) } fmt.Printf("Hi %s, you have %d apps\n", me.User.Name, len(me.Applications))}Gli SDK per JavaScript, Python e Go coprono ogni operazione del riferimento dell’API e vengono verificati rispetto alla sua specifica OpenAPI a ogni esecuzione della CI. I nomi dei metodi qui sotto sono in JavaScript; Python usa snake_case e Go usa PascalCase.
Leggi lo stato di un’applicazione o di tutte, avviale, arrestale e riavviale, e recupera log e metriche di CPU, RAM e rete.
apps.statusAllapps.restartapps.logsapps.metrics
Crea un’applicazione da uno zip, fai il commit di nuovi file, collega un repository e un branch GitHub o imposta un webhook, ed elenca i deploy passati.
apps.createapps.commitdeploys.linkGithubApp
Elenca, leggi, scrivi, sposta ed elimina i file della tua applicazione, e leggi, imposta o sostituisci le sue variabili d’ambiente.
files.writefiles.readenvs.set
Segui log e stato di un’applicazione mentre accadono, come un iteratore da scorrere in un ciclo. Una connessione caduta si riapre da sola.
apps.realtime
Crea, elenca e ripristina snapshot di applicazioni e database, e scarica un file di snapshot come stream.
snapshots.createsnapshots.restoredownloadSnapshot
Imposta un dominio personalizzato, leggi i suoi record DNS, svuota la cache e interroga analytics, errori e prestazioni per un intervallo di tempo.
network.setDomainnetwork.purgeCachenetwork.analytics
Crea database MongoDB, PostgreSQL, MySQL e Redis, modificane la RAM, leggine lo stato e reimposta una password o un certificato.
databases.createdatabases.resetCredentials
Crea spazi di lavoro, aggiungi membri con un codice di invito, cambia il loro gruppo e condividi applicazioni con il tuo team.
workspaces.members.addworkspaces.apps.add
Invia una richiesta di chat compatibile con OpenAI all’AI Gateway di Square Cloud con lo stesso client e la stessa chiave.
ai.chat
@squarecloud/blob è l’SDK per Blob Storage: upload, file privati, link di condivisione, regole per cartella e il gateway compatibile con S3, su Node.js e nel browser. Scopri Blob Storage
Passa il percorso di un file, un Blob o dei byte. I file grandi vengono caricati in parti parallele, fino a 10 GiB, in stream dal disco.
putlist
Un file privato non ha un URL pubblico. Crea un link di download che scade, o un link di condivisione che puoi revocare in qualsiasi momento.
downloadUrlshares.createshares.revoke
Il tuo server crea un token di upload di breve durata e il browser carica con quello, così la chiave API non lascia mai il tuo server.
uploadTokens.create
Ogni SDK usa solo la libreria standard del proprio linguaggio o il fetch della piattaforma, quindi non aggiunge nient’altro al tuo lockfile.
Ogni errore dell’API, di rete o locale lancia la stessa classe di errore, con lo stato HTTP e il codice di errore dell’API.
Un timeout di 30 secondi per tentativo, e nuovi tentativi solo per gli errori che si possono ripetere senza rischi, mai per un 429.
Una chiave può essere limitata ad alcuni permessi e a specifiche applicazioni o database. Gli elenchi restituiscono solo ciò che può vedere.
La stessa chiave API e la stessa variabile SQUARECLOUD_API_KEY funzionano nel terminale, in CI, nel tuo editor e nel tuo codice.
Dal primo deploy a 1 TB di RAM, senza cambiare piattaforma. Ogni fase aggiunge memoria e funzionalità alla precedente, e l'upgrade vale subito.
Porta l'idea fuori dal localhost e mettila online.
A partire da12,49 BRL/mese≈ 2,00 €
Produzione con database, dominio personalizzato e team.
A partire da44,99 BRL/mese≈ 7,20 €
Più memoria, snapshot giornalieri e visibilità su ciò che gira.
A partire da124,99 BRL/mese≈ 20,00 €
Grandi operazioni, con un canale Discord privato.
A partire da299,90 BRL/mese≈ 47,98 €
| Hobby | Standard | Pro | Enterprise | |
|---|---|---|---|---|
| Calcolo | ||||
| Memoria RAM | 1 GB → 2 GB | 4 GB → 8 GB | 12 GB → 24 GB | 32 GB → 1 TB |
| vCPU | 1 → 2 | 4 | 6 → 12 | 16 |
| Piattaforma | ||||
| Metriche in tempo reale | Incluso | Incluso | Incluso | Incluso |
| Blob Storage | Incluso | Incluso | Incluso | Incluso |
| Rollback con 1 clic | Incluso | Incluso | Incluso | Incluso |
| Square Shield anti-DDoS | Incluso | Incluso | Incluso | Incluso |
| Database | Non incluso | Incluso | Incluso | Incluso |
| Dominio personalizzato | Non incluso | Incluso | Incluso | Incluso |
| Load balancerapp per dominio | Non incluso | 2 | 5 | 10 |
| AI Gateway | Non incluso | Incluso | Incluso | Incluso |
| Snapshot giornalieri delle applicazioni | Non incluso | Non incluso | Incluso | Incluso |
| Analisi delle prestazioni | Non incluso | Non incluso | Incluso | Incluso |
| Team e supporto | ||||
| Workspacemembri per workspace | Non incluso | 3 → 7 | 10 → 20 | 20 → 50 |
| Supporto prioritario | Non incluso | Non incluso | Incluso | Incluso |
| Canale Discord privato | Non incluso | Non incluso | Non incluso | Incluso |
4,9 su 5
482 recensioni su Google e Trustpilot
Ospitato in un datacenter partner con certificazioni
JavaScript e TypeScript (@squarecloud/api), Python (squarecloud-api) e Go (github.com/squarecloudofc/sdk-api-go). Blob Storage ha il proprio SDK JavaScript, @squarecloud/blob. Tutti e quattro sono open source su GitHub.
Sì. Gli SDK per JavaScript, Python e Go coprono ogni operazione del riferimento dell’API di Square Cloud, più il download degli snapshot, e vengono verificati rispetto alla sua specifica OpenAPI a ogni esecuzione della CI. Blob Storage e il suo gateway compatibile con S3 sono coperti da @squarecloud/blob.
Gli SDK sono pacchetti open source. L’API che chiamano è inclusa in tutti i piani di Square Cloud, a partire da Hobby, e il numero di richieste al minuto dipende dal piano.
Nella variabile d’ambiente SQUARECLOUD_API_KEY, mai nel codice sorgente. Dai a ogni chiave solo i permessi e le risorse di cui ha bisogno, e revocala nelle impostazioni di sicurezza del tuo account se viene esposta.
Gli SDK dell’API sono pensati per i server: Node.js, Deno, Bun, runtime edge, Python e Go. In un browser la chiave API sarebbe esposta. Per gli upload dal browser, @squarecloud/blob usa un token di upload di breve durata creato dal tuo server.
Le versioni attuali sono state riscritte: i metodi stanno sul client, le risposte sono dati semplici con i nomi dei campi dell’API e ogni errore ha un solo tipo. La documentazione di ogni SDK include una guida alla migrazione dalla versione major precedente.
Usa un SDK quando la chiamata sta nel tuo codice, come un comando di un bot che riavvia un’applicazione o uno script che crea uno snapshot. Usa la CLI nel terminale e la GitHub Action per fare il deploy a ogni push.