Lista de Objetos Blob - Square Cloud

GET

objects

Lista de Objetos Blob

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

import requests

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

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

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

}

HttpResponse<String> response = Unirest.get("https://blob.squarecloud.app/v1/objects")
  .header("Authorization", "<authorization>")
  .asString();

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

obrigatório

A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.

Lista de objetos enumera os arquivos armazenados na sua conta, opcionalmente restritos a um prefixo de nome, e pagina buckets grandes com um token de continuação em vez de retornar tudo de uma vez. Use para montar um navegador de arquivos, confirmar que um upload chegou, ou conferir seus próprios registros contra o que a Square Cloud realmente armazena. Cada página fica em cache por conta, prefixo e token por 30 minutos, então chamadas repetidas com os mesmos parâmetros são servidas do cache em vez de acessar o armazenamento novamente. Chamadas além de 10 requisições a cada 30 segundos ficam bloqueadas por 5 minutos. Objetos enviados com expiração carregam um campo expires_at; objetos permanentes o omitem. Para remover um objeto depois de encontrar seu ID, veja Exclusão de objeto; para enviar novos arquivos, veja Envio de objeto.

string

Uma string representando o prefixo do arquivo.
Deve obedecer ao padrão a a z, A a Z, 0 a 9 e _ (3 a 32 caracteres).

string

Uma string representando o token de continuação para a listagem de arquivos. (1000 objetos por página)

Resposta

string

Indica se a chamada foi bem-sucedida. “success” se bem-sucedida, “error” caso contrário.

object

Mostrar Alternar objeto

array

Mostrar Alternar objeto

string

O id do objeto.

integer

O tamanho do objeto em bytes.

ISO 8601

A data e hora em que o objeto foi criado.

ISO 8601

A data e hora em que o objeto irá expirar.

string

Token para buscar a próxima página; reenvie-o como o parâmetro de query continuationToken. null ou ausente quando não há mais 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
  }
}

Solução de problemas

Código 400
Código 401
Código 429

Relacionado ao Objeto

// O prefixo do objeto fornecido é inválido.
// Deve obedecer ao padrão a a z, A a Z, 0 a 9 e _.
{
    "status": "error",
    "code": "INVALID_OBJECT_PREFIX"
}

// O token de continuação fornecido é inválido (deve ser uma string de até 2048 caracteres).
{
    "status": "error",
    "code": "INVALID_CONTINUATION_TOKEN"
}

// A requisição para listar os objetos falhou. Tente novamente.
{
    "status": "error",
    "code": "LIST_FAILED"
}

Não autorizado

// A chave de API está ausente ou é inválida. Defina uma chave válida no cabeçalho Authorization.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

Limite de requisições

// Limite de listagens atingido (10 requisições por janela de 30s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Envio de ObjetoEsta documentação fornece uma visão abrangente do endpoint POST /v1/objects da API Blob da SquareCloud.

Lista de Objetos Blob

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

import requests

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

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

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

}

HttpResponse<String> response = Unirest.get("https://blob.squarecloud.app/v1/objects")
  .header("Authorization", "<authorization>")
  .asString();

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

​Resposta

​Solução de problemas

​Relacionado ao Objeto

​Não autorizado

​Limite de requisições

Resposta

Solução de problemas

Relacionado ao Objeto

Não autorizado

Limite de requisições