Listar Gravações de uma Chamada

O endpoint /api/calls/{id}/recordings permite listar as gravações de uma chamada utilizando seu Token de API.

Requisição

Lista as gravações de uma chamada específica do projeto.

Cabeçalhos:

{
  "Authorization": "Bearer {API_TOKEN}"
}

Parâmetros de consulta

• page: (number) página de paginação. Padrão: 1
• limit: (number) Quantidade de itens a serem retornados (10-100). Padrão: 10

Exemplos de Implementação

curl -X GET "https://api.videochamada.com.br/api/calls/{id}/recordings?page=1&limit=20" \
  -H "Authorization: Bearer {API_TOKEN}"

import requests

response = requests.get(
    "https://api.videochamada.com.br/api/calls/{id}/recordings",
    headers={"Authorization": "Bearer {API_TOKEN}"},
    params={"page": 1, "limit": 20}
)

const response = await fetch('https://api.videochamada.com.br/api/calls/{id}/recordings?page=1&limit=20', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {API_TOKEN}'
  }
});

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer {API_TOKEN}");
var response = await client.GetAsync("https://api.videochamada.com.br/api/calls/{id}/recordings?page=1&limit=20");

Resposta

Exemplo de Resposta:

{
  "data": [
    {
      "id": "rec_123",
      "callId": "call_456",
      "status": "completed",
      "duration": 1800,
      "size": 15728640,
      "created": "2025-06-11T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5,
    "totalPages": 1
  }
}

Explicação dos Campos:

Objeto de Gravação:

• id: Identificador único da gravação
• callId: Identificador da chamada associada
• status: Status da gravação (ex: "completed", "processing", "failed")
• duration: Duração da gravação em segundos
• size: Tamanho do arquivo em bytes
• created: Data e hora de criação da gravação

Objeto de Paginação:

• page: Número da página atual
• limit: Quantidade de itens por página
• total: Total de gravações disponíveis
• totalPages: Total de páginas

Boas Práticas

• Paginação: Para grandes volumes de gravações, utilize os parâmetros de paginação para otimizar o desempenho.
• Monitoramento de Status: Verifique o status das gravações antes de tentar baixá-las ou processá-las.
• Limites: Respeite os limites de requisições por minuto definidos pela API.