Autenticazione

Per prima cosa devi ottenere una chiave API dal Developer Dashboard. Puoi usare questa chiave API per autenticarti alla Square Cloud API.

'Authorization': '<api_key>'

Utilizzo dell’API

Puoi usare la chiave API per autenticarti alla Square Cloud API. Puoi usare la chiave API nell’header Authorization. Ricorda che l’uso dell’API è soggetto ai Termini di Servizio e alla Politica di Uso Accettabile.

Codici di errore

Le risposte di errore seguono il formato { "status": "error", "code": "UN_CODICE" }. A luglio 2026 diversi codici sono stati rinominati secondo una convenzione coerente (INVALID_X, X_NOT_FOUND, X_FAILED, X_LIMIT_REACHED): la tabella completa è nel changelog.

{
    "status": "error",
    "code": "RATE_LIMITED"
}

Errori globali

Qualsiasi rotta Blob può restituire anche questi:

Codice	HTTP	Significato
`ACCESS_DENIED`	401	La chiave API è mancante o non valida.
`RATE_LIMIT`	429	Limite di frequenza globale del livello di autenticazione. Nota il nome esatto: i limiti di frequenza per singola rotta usano `RATE_LIMITED`.
`ROUTE_NOT_FOUND` / `NOT_FOUND`	404	La rotta richiesta non esiste.
`INTERNAL_SERVER_ERROR`	500	Errore interno imprevisto. Riprova più tardi.

Limiti e restrizioni

Scopri i limiti e le restrizioni della Square Cloud API.

MetricheQuesta documentazione fornisce una panoramica completa dell'endpoint GET /v1/account/stats dell'API Blob di SquareCloud.

Endpoint Blob

Upload a Blocchi

Utilizzo dell’API

Codici di errore

Errori globali

Limiti e restrizioni

​Utilizzo dell’API

​Codici di errore

​Errori globali

Limiti e restrizioni

Utilizzo dell’API

Codici di errore

Errori globali