Restituisce le visite di un sito per un mese, con i totali e i dettagli su pagine, browser, sistemi operativi e provenienze.
GEThttps://console.icbs.it/api/v1/hosting/{sito}/traffic| Parametro | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
sito | indirizzo | sì | Il nome del sito, per esempio esempio.it. |
month | query | no | Mese nel formato 2026-08. Se omesso vale il mese corrente. |
curl -H "Authorization: Bearer $ICBS_API_KEY" \
"https://console.icbs.it/api/v1/hosting/esempio.it/traffic?month=2026-07"
{
"hostname": "esempio.it",
"month": "2026-07",
"available": true,
"availableMonths": ["2026-05", "2026-06", "2026-07"],
"totals": { "visits": 4812, "pages": 19240, "bandwidthBytes": 3221225472 },
"days": [{ "day": "2026-07-01", "visits": 148 }],
"pages": [{ "url": "/", "views": 3410 }],
"browsers": [{ "name": "Chrome", "hits": 2890 }],
"operatingSystems": [{ "name": "Windows", "hits": 2100 }],
"referrers": [{ "source": "google", "hits": 1520 }]
}
availableMonths elenca i mesi per cui esistono dati: usalo per costruire un report senza indovinare da quando partire né interrogare mesi vuoti.
Se il mese richiesto non ha dati, available è false e gli elenchi arrivano vuoti — non è un errore.
Questa chiamata restituisce solo dati aggregati. L'elenco degli indirizzi IP di chi ha visitato il sito non esce dall'API: sono dati personali di persone che non sono tue clienti. Restano consultabili in console.
| Codice | Causa |
|---|---|
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Alla chiave manca il permesso Hosting — lettura. |
404 | Il sito non esiste o la chiave non vi ha accesso. |
429 | Superato il limite di richieste. |