Documentação

Referência da API

Consultar imagem de referência

GET/v1/image-assets/{asset_id}

Mesma conta e chave; recurso expirado retorna 410; exclusão com referência de tarefa não concluída retorna 409.

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 caminho

  • asset_idstringObrigatório

    ID de recurso de imagem ia_ enviado com a mesma chave.

Respostas e erros

HTTP 200

Imagem de referência consultada com sucesso

application/json

Tipo
object
Campos obrigatórios
idmime_typesize_byteswidthheightexpires_at
  • file_idstringOpcional

    ID público de arquivo gerenciado da mesma conta e chave.

  • idstringObrigatório

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

  • mime_typestringObrigatório

    Tipo MIME verificado do arquivo.

  • size_bytesintegerObrigatório

    Tamanho do arquivo em bytes.

  • widthintegerObrigatório

    Largura da imagem em pixels.

  • heightintegerObrigatório

    Altura da imagem em pixels.

  • expires_atintegerObrigatório

    Segundos Unix; 0 indica ausência de expiração fixa. O upload é associado a arquivo gerenciado; leitura exige a mesma conta e chave.

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 410

A imagem de referência expirou ou foi excluída (asset_expired).

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.