> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Lista de Objetos Blob

> Esta documentação fornece uma visão abrangente do endpoint GET /v1/objects da API Blob da SquareCloud.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

<ParamField query="prefix" type="string" placeholder="File Prefix">
  Uma string representando o prefixo do arquivo.<br />Deve obedecer ao padrão a a z, A a Z, 0 a 9 e \_ (3 a 32 caracteres).
</ParamField>

<ParamField query="continuationToken" type="string" placeholder="Continuation Token">
  Uma string representando o token de continuação para a listagem de arquivos. (1000 objetos por página)
</ParamField>

### Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida. "success" se bem-sucedida, "error" caso contrário.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="Alternar objeto">
    <ResponseField name="objects" type="array">
      <Expandable title="Alternar objeto">
        <ResponseField name="id" type="string">
          O id do objeto.
        </ResponseField>

        <ResponseField name="size" type="integer">
          O tamanho do objeto em bytes.
        </ResponseField>

        <ResponseField name="created_at" type="ISO 8601">
          A data e hora em que o objeto foi criado.
        </ResponseField>

        <ResponseField name="expires_at" type="ISO 8601">
          A data e hora em que o objeto irá expirar.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response - [30s cache] theme={null}
  {
    "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"
        },
      ]
    }
  }
  ```
</ResponseExample>

### Solução de problemas

<Tabs>
  <Tab title="Código 400">
    ### Relacionado ao Objeto

    <CodeGroup>
      ```json INVALID_PREFIX theme={null}
      // 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"
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Código 401">
    ### Não autorizado

    <CodeGroup>
      ```json ACCESS_DENIED theme={null}
      // A chave de API está ausente ou é inválida. Defina uma chave válida no cabeçalho Authorization.
      {
          "status": "error",
          "code": "ACCESS_DENIED"
      }
      ```
    </CodeGroup>
  </Tab>
</Tabs>