Skip to main content
GET
curl
Devolve os arquivos já confirmados, na ordem do nome, e o uso da cota do plano (usage). Para navegar por pastas, mande delimiter=/ e o prefix da pasta (img/): o que fica dentro de uma subpasta vem junto em folders. Funciona com a chave de leitura, a de leitura e escrita e a Só Blob. Guia completo em Blob.
Com mais itens que o limit, a resposta traz nextCursor: mande de volta em cursor para a próxima página, até ele vir null.

Erros comuns

Todos os códigos, com o formato do erro, em Códigos de erro.

Autorizações

Authorization
string
header
obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Parâmetros de consulta

prefix
string

O começo do nome (ex.: img/).

Maximum string length: 1024
delimiter
enum<string>

Só /: junta as subpastas em folders.

Opções disponíveis:
/

Texto que o nome precisa conter.

Maximum string length: 200
cursor
string

O nextCursor da página anterior.

limit
integer
padrão:100

Itens por página, de 1 a 1000.

Intervalo obrigatório: 1 <= x <= 1000

Resposta

Os arquivos, as subpastas e o uso da cota.

objects
object[]
obrigatório
folders
object[]
obrigatório

Com delimiter=/: as subpastas da pasta pedida.

nextCursor
string | null
obrigatório

Para a próxima página, em cursor; null na última.

usage
object
obrigatório