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

requerido

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

S3 Credentials devuelve el par de claves de acceso que las herramientas S3 usan para firmar solicitudes al gateway S3. El par se deriva de la API key que llama a esta ruta: llamar de nuevo devuelve el mismo par, y revocar, regenerar o dejar expirar la key hace lo mismo con el par. No hay nada más que rotar ni revocar. Llámala con una API key que tenga blob:read o blob:write. El par puede leer con blob:read y escribir con blob:write, como muestra el campo access.

La secret_access_key da el mismo acceso que la API key. Guárdala igual que la propia key.

El par no cambia mientras la API key no cambie. Obtenlo una vez y guárdalo en tu gestor de secretos o en una variable de entorno: no llames a esta ruta cada vez que tu aplicación arranque.

Límites de tasa

10 solicitudes por hora por cuenta (RATE_LIMITED, 429).

Respuesta

string

“success” si tuvo éxito, “error” si no.

object

Mostrar Alternar objeto

string

El id de la clave de acceso (SQ2_...).

string

La clave de acceso secreta.

string

https://s3-blob.squarecloud.app

string

auto

string[]

Los buckets de tu cuenta: public, private y legacy.

object

read y write, cada uno true o false, según los scopes de la key.

ISO 8601 | null

Cuándo expira la API key, y por tanto el par. null cuando no expira.

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
  }
}

Errores

Código	HTTP	Cuándo
`API_KEY_REQUIRED`	400	Se llamó con una sesión del dashboard. Usa una API key.
`LEGACY_API_KEY`	400	La key usa un formato antiguo que no puede firmar solicitudes S3. Crea una API key nueva.
`INVALID_CREDENTIAL`	401	No se pudo verificar la API key.
`MISSING_SCOPE`	403	La key no tiene ni `blob:read` ni `blob:write`.
`RATE_LIMITED`	429	Más de 10 solicitudes en una hora.

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
  }
}

Primeros Pasos

Objetos

Subida en Partes

Cuenta

Enlaces Compartidos

S3

Límites de tasa

Respuesta

Errores

​Límites de tasa

​Respuesta

​Errores

Límites de tasa

Respuesta

Errores