Saltar para o conteúdo

Consultar relatórios

GET /report devolve os registros de transferência do usuário autenticado.

Parâmetros

ParâmetroObrigatórioPadrãoDescrição
filterdirectionSim—Tipo de transferência: 5 = downloads concluídos (o usuário recebeu o arquivo; evento STCPEVTENDSENDFILE) ou 7 = uploads concluídos (o usuário enviou o arquivo; evento STCPEVTENDRECEIVEFILE). Outros valores retornam 400.
daysNão1Período consultado, em dias, contado até o momento da consulta. 0 ou valor inválido usa 1.
pageNão0Página do resultado, a partir de 0. Cada página tem até 100 registros (limite configurável pelo administrador, até 1000).
filterfileNão—Filtro por trecho do nome do arquivo.

O relatório traz somente as transferências concluídas com sucesso pelo usuário autenticado.

Consultar

curl -s -G \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  --data-urlencode 'filterdirection=5' \
  --data-urlencode 'days=7' \
  --data-urlencode 'page=0' \
  --data-urlencode 'filterfile=relatorio' \
  "$API_BASE/report"

Remova filterfile quando não precisar filtrar pelo nome.

Resposta

{
  "status": 0,
  "description": "<descrição retornada pela API>",
  "apiver": "v2 (9.0.1)",
  "user": "USUARIO",
  "page": 0,
  "logs": [],
  "time": "<data e hora>"
}

Cada elemento de logs é um registro de transferência retornado para a consulta. Os identificadores de evento que podem aparecer nos registros estão em Eventos de sessão e transferência.

Contrato completo em Referência: Relatórios.