Descubra Como Listar Assets na API do RenderNet.ai Agora Mesmo!
A API do RenderNet.ai é uma ferramenta poderosa que oferece uma maneira fácil e eficaz de gerenciar seus assets. Com o endpoint de listagem de assets, você pode recuperar informações detalhadas sobre os ativos que você carregou na plataforma, como dimensões, status, URL, tags e tipo. Neste tutorial, vamos guiá-lo pelo processo de como utilizar esse recurso incrível para otimizar seu fluxo de trabalho e obter os dados que você precisa.
Como Acessar a API e Listar Assets
Para começar, é essencial que você tenha seu X-API-KEY em mãos. Este é um código único que permite que você acesse os endpoints públicos da RenderNet.ai. Se você ainda não possui essa chave, pode encontrá-la na seção ‘Conta’ do seu perfil na plataforma.
Uma vez que você tenha sua chave de API, o próximo passo é fazer uma requisição GET ao endpoint específico. O URL para esta requisição é:
https://api.rendernet.ai/pub/v1/assets
Fazendo a Requisição
A configuração da requisição pode ser realizada utilizando várias linguagens de programação, como cURL, Python, JavaScript, entre outras. Vamos ver um exemplo utilizando cURL:
curl --request GET \ --url https://api.rendernet.ai/pub/v1/assets \ --header 'X-API-KEY:
É importante notar que esta requisição pode retornar uma lista paginada, o que significa que você pode precisar especificar quais dados deseja visualizar usando parâmetros de consulta como page e page_size.
Entendendo a Resposta da API
Ao realizar a requisição, você receberá uma resposta em formato JSON. A estrutura da resposta inclui informações cruciais sobre os assets. O objeto data contém uma lista de assets, onde cada item possui detalhes como:
- size: As dimensões do asset (altura e largura).
- url: O link direto para acessar o asset na internet.
- status: O estado do asset, podendo ser ‘ativo’, ‘arquivado’, ‘pendente’, entre outros.
- tags: Etiquetas associadas ao asset, úteis para categorizações.
- type: O tipo de asset (por exemplo, imagem ou vídeo).
Além disso, você também encontrará detalhes sobre a paginação da resposta, que informa quantas páginas de resultados existem e qual a quantidade total de assets disponíveis.
Exemplo de Resposta
Um exemplo de resposta JSON para uma requisição bem-sucedida pode parecer com o seguinte:
{
"data": [
{
"data": {
"size": {
"height": 512,
"width": 512
},
"url": "https://rendernet.ai/assets/object-url",
"id": "asset_id",
"status": "active",
"tags": ["api"],
"type": "image"
}
}
],
"err": {},
"pagination": {
"page": 1,
"page_size": 10,
"total": 100
}
}
Explore Mais Sobre a RenderNet.ai
A RenderNet.ai oferece uma gama de funcionalidades que podem ser integradas em seus próprios projetos para melhorar a experiência do usuário. Se você está buscando entender mais sobre esta plataforma incrível e suas capacidades, visite nosso artigo sobre O que é a Rendernet.ai.
Para mais detalhes e informações sobre como utilizar a API, não hesite em acessar a documentação oficial da API da RenderNet.ai: Documentação da API.
