Obter lista de vídeos

Obter a lista de vídeos

Listar vídeos faz-se enviando um pedido GET para o endpoint /videos.

CURL


curl -X GET https://app.ignitevideo.cloud/api/videos \
-H "Authorization: Bearer YOUR_TOKEN"

JavaScript / Node.js


const response = await fetch('https://app.ignitevideo.cloud/api/videos', {
headers: {
  Authorization: `Bearer YOUR_TOKEN`
}
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://app.ignitevideo.cloud/api/videos', [
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN'
]
]);

Parâmetros de consulta

Para detalhes sobre todos os operadores disponíveis e filtragem avançada, consulta Consultas. Podes acrescentar os seguintes parâmetros de consulta ao URL do pedido:

Parâmetro	Tipo	Descrição
`page`	`number`	O número da página a obter.
`limit`	`number`	O número de vídeos a obter por página.
`sort`	`string`	O campo por que ordenar. Prefixa com `-` para ordem descendente.
`where`	`object`	Consulta personalizada para filtrar os vídeos.

Exemplo


/api/videos?page=1&limit=10&sort=-createdAt

Filtrar por estado

Um caso de uso comum é filtrar vídeos pelo estado de processamento:


/api/videos?where[status][equals]=COMPLETE

Resposta da API

A resposta é um objeto JSON com as seguintes propriedades:


{
  "docs": [...], // Array of video objects
  "totalDocs": number,
  "limit": number,
  "totalPages": number,
  "page": number,
  "pagingCounter": number,
  "hasPrevPage": boolean,
  "hasNextPage": boolean,
  "prevPage": number | null,
  "nextPage": number | null
}