Informes
Guía relacionada: Consultar informes.
GET /report
Consulta los registros de transferencia del usuario autenticado.
Acceso: sesión (token Bearer o cookie).
| Parámetro | Ubicación | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|---|
filterdirection | query | integer | Sí | — | Tipo de transferencia: 5 = descargas concluidas (el usuario recibió el archivo; evento STCPEVTENDSENDFILE) o 7 = cargas concluidas (el usuario envió el archivo; evento STCPEVTENDRECEIVEFILE). Otros valores devuelven 400. |
days | query | integer | No | 1 | Período consultado, en días, contado hasta el momento de la consulta. 0 o un valor no válido usa 1. |
page | query | integer | No | 0 | Página del resultado, a partir de 0. Cada página tiene hasta 100 registros (límite configurable por el administrador, hasta 1000). |
filterfile | query | string | No | — | Filtro por parte del nombre del archivo. |
El informe devuelve solo las transferencias concluidas con éxito por el usuario autenticado.
Respuestas
| HTTP | Significado | Cuerpo |
|---|---|---|
200 | Registros de transferencia. | ReportResponse |
401 | Credencial no aceptada. | — |
400 | filterdirection ausente o distinto de 5 y 7. | — |
403 | Conexión del usuario bloqueada o fuera de la ventana horaria. | — |
GET /directlink/v2/report?filterdirection=5&days=7&page=0 HTTP/1.1
Host: api.ejemplo.com
Authorization: Bearer <access_token>
Accept: application/json