Relatórios
Guia relacionado: Consultar relatórios.
GET /report
Consulta os registros de transferência do usuário autenticado.
Acesso: sessão (token Bearer ou cookie).
| Parâmetro | Local | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|---|
filterdirection | query | integer | Sim | — | 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. |
days | query | integer | Não | 1 | Período consultado, em dias, contado até o momento da consulta. 0 ou valor inválido usa 1. |
page | query | integer | Não | 0 | Página do resultado, a partir de 0. Cada página tem até 100 registros (limite configurável pelo administrador, até 1000). |
filterfile | query | string | Não | — | Filtro por trecho do nome do arquivo. |
O relatório traz somente as transferências concluídas com sucesso pelo usuário autenticado.
Respostas
| HTTP | Significado | Corpo |
|---|---|---|
200 | Registros de transferência. | ReportResponse |
401 | Credencial não aceita. | — |
400 | filterdirection ausente ou diferente de 5 e 7. | — |
403 | Conexão do usuário bloqueada ou fora da janela de horário. | — |
GET /directlink/v2/report?filterdirection=5&days=7&page=0 HTTP/1.1
Host: api.exemplo.com
Authorization: Bearer <access_token>
Accept: application/json