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

erforderlich

Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.

Objektliste listet die unter deinem Konto gespeicherten Dateien auf, optional eingegrenzt auf ein Namenspräfix, und paginiert durch große Bestände mit einem Continuation-Token, statt alles auf einmal zurückzugeben. Nutze sie, um einen Datei-Browser zu bauen, einen Upload zu bestätigen oder deine eigenen Aufzeichnungen mit dem abzugleichen, was Square Cloud tatsächlich vorhält. Jede Seite wird pro Konto, Präfix und Token 30 Minuten lang gecacht, sodass wiederholte Aufrufe mit denselben Parametern aus dem Cache bedient werden, statt erneut den Speicher abzufragen. Aufrufe über 10 Anfragen pro 30 Sekunden hinaus werden für 30 Sekunden blockiert. Mit einer Ablaufzeit hochgeladene Objekte tragen ein Feld expires_at; dauerhafte Objekte lassen es aus. Um ein Objekt zu entfernen, sobald du seine ID gefunden hast, siehe Objekt löschen; um neue Dateien hochzuladen, siehe Object Post.

string

Eine Zeichenkette, die den Präfix für die Datei darstellt.
Muss dem Muster a bis z, A bis Z, 0 bis 9 und _ entsprechen. (3 bis 32 Zeichen)

string

Eine Zeichenkette, die das Continuation-Token für die Dateiliste darstellt. (1000 Objekte pro Seite)

Antwort

string

Gibt an, ob der Aufruf erfolgreich war. “success” bei Erfolg, “error” bei Misserfolg.

object

Anzeigen Objekt umschalten

array

Anzeigen Objekt umschalten

string

Die ID des Objekts.

integer

Die Größe des Objekts in Bytes.

ISO 8601

Das Datum und die Uhrzeit, zu der das Objekt erstellt wurde.

ISO 8601

Das Datum und die Uhrzeit, zu der das Objekt abläuft.

string

Token zum Abrufen der nächsten Seite; übergib es erneut als continuationToken-Query-Parameter. null oder nicht vorhanden, wenn es keine weiteren Objekte gibt.

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

Fehlerbehebung

Statuscode 400
Statuscode 401
Statuscode 429

Objektbezogen

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

Nicht autorisiert

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

Rate-Limit erreicht

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

Zurück

Object PostDiese Dokumentation bietet einen umfassenden Überblick über den Endpoint POST /v1/objects der SquareCloud Blob API.

Weiter

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

Blob-Endpunkte

Chunked-Uploads

Antwort

Fehlerbehebung

Objektbezogen

Nicht autorisiert

Rate-Limit erreicht

​Antwort

​Fehlerbehebung

​Objektbezogen

​Nicht autorisiert

​Rate-Limit erreicht

Antwort

Fehlerbehebung

Objektbezogen

Nicht autorisiert

Rate-Limit erreicht