Documentação

Referência da API

Consultar arquivos gerenciados

GET/v1/files

Arquivos históricos da mesma conta e chave; permite chaves válidas com cota esgotada, mas rejeita revogadas/expiradas. Download exige ready; exclusão com referências retorna 409. retry só salva o original, sem regenerar. API comum por dias; tarefas persistentes protegem referências; expires_at=0 indica ausência de expiração fixa.

Autenticação e permissões

Use sua chave atual do GloopAPI. Modelos, recursos e permissões disponíveis dependem do catálogo da chave e da documentação do endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticação: BearerAuth

Solicitação

Parâmetros de consulta

  • afterintegerOpcional

    Use next_cursor da resposta original; o serviço fixa 50 itens por página.

    Valor padrão
    0
    Mínimo
    0

Respostas e erros

HTTP 200

Arquivos gerenciados consultados com sucesso

application/json

Tipo
object
Campos obrigatórios
datanext_cursor
  • dataarrayObrigatório
    Campos filhos de data (1)
    • []objectOpcional
      Campos filhos de [] (13)
      • idstringObrigatório

        Identificador público do objeto, usado na sua rota de detalhes.

      • source_kindstringObrigatório

        Categoria de origem do arquivo; determina ciclo de vida e proteção por referências.

      • source_indexintegerObrigatório

        Índice do resultado de origem.

      • modelstringObrigatório

        ID público do modelo no catálogo da chave atual.

      • statusstringObrigatório

        Etapas de armazenamento em segundo plano, como waiting/pending/archiving/ready/failed/deleting; URL de download só é obtida após ready.

      • mime_typestringObrigatório

        Tipo MIME verificado do arquivo.

      • file_namestringObrigatório

        Nome público do arquivo baixado.

      • sha256stringOpcional

        SHA-256 do conteúdo arquivado, se conhecido.

      • size_bytesintegerObrigatório

        Tamanho do arquivo em bytes.

      • error_codestringOpcional

        Código público de erro para decisões de fluxo.

      • created_atintegerObrigatório

        Data de criação em segundos Unix.

      • updated_atintegerObrigatório

        Última atualização em segundos Unix.

      • expires_atintegerObrigatório

        Segundos Unix; 0 indica retenção prolongada. A API comum segue os dias configurados; imagens/vídeos persistentes protegem resultados por referências. A exclusão preserva cobrança e idempotência.

  • next_cursorintegerObrigatório

HTTP 400

Campos ou parâmetros de solicitação inválidos.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 401

A chave está ausente, inválida, expirada ou revogada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 403

Permissões insuficientes de IP, conta, modelo ou ferramenta.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 404

Objeto/recurso indisponível ou função desativada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 409

Conflito de idempotência/cotação, objeto não pronto ou ainda referenciado.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 429

Limite de solicitações/fila.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 500

Falha interna de autenticação ou armazenamento de dados.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 503

Serviço, preços ou armazenamento indisponíveis.

application/json

Tipo
object
Campos obrigatórios
error
Pronto para criar? Abra console para criar uma chave de API, ou explore recursos.