Configurare la Stats API

In “Settings → Stats API”, aggiungi un’etichetta se vuoi, come lo strumento che userà la chiave, e scegli Create. Copia la chiave quando compare: viene mostrata una sola volta.

Un account può avere cinque chiavi. Dai a ogni strumento la sua, così puoi revocarne una senza fermare le altre.

Ogni richiesta chiede un tipo di statistiche per un periodo, con la chiave nell’intestazione Authorization, o nell’indirizzo come &api_key=… per gli strumenti che non possono impostare intestazioni:

Sostituisci device con redirect, country, referrer o utm, e scegli il periodo: day per ieri, month per gli ultimi 30 giorni o full per gli ultimi 400 giorni. La risposta elenca ogni Onelink con le sue statistiche giorno per giorno. Il riferimento completo, con una risposta di esempio per ogni tipo, si trova in “Settings → Stats API”.

Le statistiche coprono giorni completi, conteggiati in UTC, e vengono preparate poco dopo la mezzanotte UTC, quindi basta un’esecuzione dopo le 01:00 UTC. Ogni chiave può fare 50 richieste al giorno e 5 al minuto.

Se le statistiche sono ancora in preparazione, la risposta è 202 con un elenco vuoto. Riprova dopo cinque minuti. Succede soprattutto alla prima richiesta per un tipo di statistiche.