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

obbligatorio

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

Object List enumera i file memorizzati nel tuo account, opzionalmente limitati a un prefisso di nome, e pagina i bucket di grandi dimensioni tramite un token di continuazione invece di restituire tutto in una volta. Usalo per costruire un file browser, confermare che un upload sia andato a buon fine, o riconciliare i tuoi record con ciò che Square Cloud effettivamente contiene. Ogni pagina viene messa in cache per account, prefisso e token per 30 minuti, quindi chiamate ripetute con gli stessi parametri vengono servite dalla cache invece di interrogare nuovamente lo storage. Le chiamate oltre le 10 richieste ogni 30 secondi vengono bloccate per 30 secondi. Gli oggetti caricati con una scadenza hanno un campo expires_at; gli oggetti permanenti lo omettono. Per rimuovere un oggetto una volta trovato il suo ID, vedi Object Delete; per caricare nuovi file, vedi Object Post.

string

Una stringa che rappresenta il prefisso del file.
Deve rispettare il pattern a to z, A to Z, 0 to 9, and _. (da 3 a 32 caratteri)

string

Una stringa che rappresenta il token di continuazione per l’elenco dei file. (1000 oggetti per pagina)

Risposta

string

Indica se la chiamata ha avuto successo. “success” in caso di successo, “error” in caso contrario.

object

Mostra Mostra oggetto

array

Mostra Mostra oggetto

string

L’id dell’oggetto.

integer

La dimensione dell’oggetto in byte.

ISO 8601

La data e l’ora in cui l’oggetto è stato creato.

ISO 8601

La data e l’ora in cui l’oggetto scadrà.

string

Token per recuperare la pagina successiva; passalo di nuovo come parametro di query continuationToken. null o assente quando non ci sono più oggetti.

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

Risoluzione dei problemi

Codice di stato 400
Codice di stato 401
Codice di stato 429

Relativi all’oggetto

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

Non autorizzato

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

Limite di frequenza

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

Object PostQuesta documentazione fornisce una panoramica completa dell'endpoint POST /v1/objects dell'API Blob di SquareCloud.

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

Endpoint Blob

Upload a Blocchi

Risposta

Risoluzione dei problemi

Relativi all’oggetto

Non autorizzato

Limite di frequenza

​Risposta

​Risoluzione dei problemi

​Relativi all’oggetto

​Non autorizzato

​Limite di frequenza

Risposta

Risoluzione dei problemi

Relativi all’oggetto

Non autorizzato

Limite di frequenza