Blob Object List

GET

objects

Blob Object List

curl --request GET \
  --url https://blob.squarecloud.app/v1/objects \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://blob.squarecloud.app/v1/objects', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://blob.squarecloud.app/v1/objects",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://blob.squarecloud.app/v1/objects"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://blob.squarecloud.app/v1/objects")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "objects": [
      {
        "id": "ID/name1_ltq7b2sw-de6241.jpeg",
        "size": 78266,
        "created_at": "2024-03-13T19:31:28.776Z"
      },
      {
        "id": "ID/name_ltq7b2sw-de6243-ex1.jpeg",
        "size": 90466,
        "created_at": "2024-03-13T19:35:28.776Z",
        "expires_at": "2024-03-14T19:35:28.776Z"
      }
    ],
    "continuationToken": null
  }
}

string

requerido

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

Object List enumera los archivos almacenados en tu cuenta, opcionalmente filtrados por un prefijo de nombre, y pagina buckets grandes mediante un token de continuación en lugar de devolver todo de una vez. Úsalo para construir un explorador de archivos, confirmar que una subida se completó, o cotejar tus propios registros con lo que Square Cloud realmente almacena. Cada página se almacena en caché por cuenta, prefijo y token durante 30 minutos, así que las llamadas repetidas con los mismos parámetros se sirven desde la caché en lugar de volver a consultar el almacenamiento. Las llamadas que superen 10 solicitudes cada 30 segundos se bloquean durante 30 segundos. Los objetos subidos con expiración incluyen un campo expires_at; los objetos permanentes lo omiten. Para eliminar un objeto una vez que encuentres su ID, consulta Object Delete; para subir nuevos archivos, consulta Object Post.

string

Una cadena que representa el prefijo del archivo.
Debe cumplir con el patrón a to z, A to Z, 0 to 9, and _. (3 a 32 caracteres)

string

Una cadena que representa el token de continuación para la lista de archivos. (1000 objetos por página)

Respuesta

string

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

object

Mostrar Alternar objeto

array

Mostrar Alternar objeto

string

El id del objeto.

integer

El tamaño del objeto en bytes.

ISO 8601

La fecha y hora en que se creó el objeto.

ISO 8601

La fecha y hora en que el objeto expirará.

string

Token para obtener la siguiente página; pásalo de nuevo como el parámetro de consulta continuationToken. null o ausente cuando no hay más objetos.

{
  "status": "success",
  "response": {
    "objects": [
      {
        "id": "ID/name1_ltq7b2sw-de6241.jpeg",
        "size": 78266,
        "created_at": "2024-03-13T19:31:28.776Z"
      },
      {
        "id": "ID/name_ltq7b2sw-de6243-ex1.jpeg",
        "size": 90466,
        "created_at": "2024-03-13T19:35:28.776Z",
        "expires_at": "2024-03-14T19:35:28.776Z"
      }
    ],
    "continuationToken": null
  }
}

Solución de problemas

Código de estado 400
Código de estado 401
Código de estado 429

Relacionado con el objeto

// The provided object prefix is invalid.
// Must adhere to the a to z, A to Z, 0 to 9, and _ pattern.
{
    "status": "error",
    "code": "INVALID_OBJECT_PREFIX"
}

// The provided continuation token is invalid (must be a string up to 2048 characters).
{
    "status": "error",
    "code": "INVALID_CONTINUATION_TOKEN"
}

// The request to list the objects failed. Please try again.
{
    "status": "error",
    "code": "LIST_FAILED"
}

No autorizado

// The API key is missing or invalid. Set a valid key in the Authorization header.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

Límite de tasa alcanzado

// List rate limit reached (10 requests per 30s window, blocked for 30s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Object PostEsta documentación ofrece una descripción completa del endpoint POST /v1/objects de la API de SquareCloud Blob.

Blob Object List

curl --request GET \
  --url https://blob.squarecloud.app/v1/objects \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://blob.squarecloud.app/v1/objects', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://blob.squarecloud.app/v1/objects",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://blob.squarecloud.app/v1/objects"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://blob.squarecloud.app/v1/objects")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "objects": [
      {
        "id": "ID/name1_ltq7b2sw-de6241.jpeg",
        "size": 78266,
        "created_at": "2024-03-13T19:31:28.776Z"
      },
      {
        "id": "ID/name_ltq7b2sw-de6243-ex1.jpeg",
        "size": 90466,
        "created_at": "2024-03-13T19:35:28.776Z",
        "expires_at": "2024-03-14T19:35:28.776Z"
      }
    ],
    "continuationToken": null
  }
}

Endpoints de Blob

Subida en Partes

Respuesta

Solución de problemas

Relacionado con el objeto

No autorizado

Límite de tasa alcanzado

​Respuesta

​Solución de problemas

​Relacionado con el objeto

​No autorizado

​Límite de tasa alcanzado

Respuesta

Solución de problemas

Relacionado con el objeto

No autorizado

Límite de tasa alcanzado