Blob S3 Credentials

GET

credentials

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/s3/credentials' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "access_key_id": "SQ2_3155597145698959364_k7Hq2mX9",
    "secret_access_key": "vR8nLq2Wz5Tc1Yb7Hs0Kd4Jf6Gm3Pa9Xe",
    "endpoint": "https://s3-blob.squarecloud.app",
    "region": "auto",
    "buckets": ["public", "private", "legacy"],
    "access": { "read": true, "write": true },
    "expires_at": null
  }
}

string

obbligatorio

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

S3 Credentials restituisce la coppia di chiavi di accesso che gli strumenti S3 usano per firmare le richieste al gateway S3. La coppia è derivata dalla chiave API che chiama questa route: chiamarla di nuovo restituisce la stessa coppia, e revocare, rigenerare o far scadere la chiave ha lo stesso effetto sulla coppia. Non c’è nient’altro da ruotare o revocare. Chiamala con una chiave API che abbia blob:read o blob:write. La coppia può leggere con blob:read e scrivere con blob:write, come indica il campo access.

La secret_access_key dà lo stesso accesso della chiave API. Conservala come la chiave stessa.

La coppia non cambia finché non cambia la chiave API. Recuperala una volta e conservala nel tuo secret manager o in una variabile d’ambiente: non chiamare questa route a ogni avvio della tua applicazione.

Limiti di frequenza

10 richieste all’ora per account (RATE_LIMITED, 429).

Risposta

string

“success” in caso di successo, “error” in caso contrario.

object

Mostra Mostra oggetto

string

L’id della chiave di accesso (SQ2_...).

string

La chiave di accesso segreta.

string

https://s3-blob.squarecloud.app

string

auto

string[]

I bucket del tuo account: public, private e legacy.

object

read e write, ciascuno true o false, in base agli scope della chiave.

ISO 8601 | null

Quando scade la chiave API, e quindi la coppia. null se non scade.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/s3/credentials' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "access_key_id": "SQ2_3155597145698959364_k7Hq2mX9",
    "secret_access_key": "vR8nLq2Wz5Tc1Yb7Hs0Kd4Jf6Gm3Pa9Xe",
    "endpoint": "https://s3-blob.squarecloud.app",
    "region": "auto",
    "buckets": ["public", "private", "legacy"],
    "access": { "read": true, "write": true },
    "expires_at": null
  }
}

Errori

Codice	HTTP	Quando
`API_KEY_REQUIRED`	400	Chiamata con una sessione della dashboard. Usa una chiave API.
`LEGACY_API_KEY`	400	La chiave usa un formato precedente che non può firmare richieste S3. Crea una nuova chiave API.
`INVALID_CREDENTIAL`	401	Non è stato possibile verificare la chiave API.
`MISSING_SCOPE`	403	La chiave non ha né `blob:read` né `blob:write`.
`RATE_LIMITED`	429	Più di 10 richieste in un’ora.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/s3/credentials' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "access_key_id": "SQ2_3155597145698959364_k7Hq2mX9",
    "secret_access_key": "vR8nLq2Wz5Tc1Yb7Hs0Kd4Jf6Gm3Pa9Xe",
    "endpoint": "https://s3-blob.squarecloud.app",
    "region": "auto",
    "buckets": ["public", "private", "legacy"],
    "access": { "read": true, "write": true },
    "expires_at": null
  }
}

Primi Passi

Oggetti

Upload a Blocchi

Account

Link di Condivisione

S3

Limiti di frequenza

Risposta

Errori

​Limiti di frequenza

​Risposta

​Errori

Limiti di frequenza

Risposta

Errori