Trend

Recupero dei trend di tutte le transazioni

Richiesta

Definizione

GET /api/v1/metrics/trends/transactions

Header

• Authorization richiesto

  Token di autenticazione con i privilegi di lettura per la risorsa.

  Bearer {token}

Parametri query string

Parametro	Tipo	Richiesto	Descrizione
timestamp_start	integer	No	Filtra i risultati relativi a un intervallo temporale successivo alla data inserita.
timestamp_end	integer	No	Filtra i risultati relativi a un intervallo temporale precedente alla data inserita.
timezone	string	No	Filtra i risultati relativi alla timezone ricercata.
host_name_list	array<string>	No	Filtra i risultati relativi alla lista di host inserita.
service	string	No	Filtra i risultati relativi al Domain Group inserito.
client_address	string	No	Filtra i risultati relativi al client address inserito.
client_address_list	array<string>	No	Filtra i risultati relativi alla lista di client address inserita.
timestamp_format	string	No	Filtra i risultati relativi al formato timestamp ricercato.
country	string	No	Filtra i risultati relativi al paese di provenienza inserito.
country_list	array<string>	No	Filtra i risultati relativi alla lista di paesi di provenienza inserita.

Risposta

Codici di stato

Codice di stato	Messaggio
200	"List of transaction trends"
400	"Error retrieving transactions."
403	"Forbidden"

Corpo

Attributi

• data.transaction.datetime string

  Timestamp in formato user-friendly relativo all'ora di riferimento delle statistiche associate.

• data.transaction.malicious array<integer>

  Lista di interi che indicano rispettivamente il numero di transazioni malevoli:

  • avvenute con successo (codici di risposta da 200 a 399)
  • fallite (codici di risposta da 400 a 499)
  • errori del server (codici di stato da 500)

• data.transaction.timestamp integer

  Timestamp in formato UNIX (microsecondi) relativo all'ora di riferimento delle statistiche associate.

• data.transaction.total array<integer>

  Lista di interi che indicano rispettivamente il numero di transazioni totali:

  • avvenute con successo (codici di risposta da 200 a 399)

  • fallite (codici di risposta da 300 a 499)

  • errori del server (codici di stato da 500)

Esempio

{
"data": {
  "transactions": [
    {
      "datetime": "2024-01-17 10:00:00Z",
      "malicious": [
        7,
        2,
        1
      ],
      "timestamp": 1705485600000000,
      "total": [
        70,
        20,
        10
      ]
    },
    {
      "datetime": "2024-01-17 11:00:00Z",
      "malicious": [
        7,
        2,
        1
      ],
      "timestamp": 1705489200000000,
      "total": [
        70,
        20,
        10
      ]
    },
    {
      "datetime": "2024-01-17 12:00:00Z",
      "malicious": [
        7,
        2,
        1
      ],
      "timestamp": 1705492800000000,
      "total": [
        70,
        20,
        10
      ]
    },
    {
      "datetime": "2024-01-17 13:00:00Z",
      "malicious": [
        0,
        0,
        0
      ],
      "timestamp": 1705496400000000,
      "total": [
        0,
        0,
        0
      ]
    }
  ]
},
"message": "List of transaction trends",
"status": "ok"
}