Attività chiave/sito
Un endpoint per tenere traccia dei siti che usano la tua chiave API Akismet.
https://rest.akismet.com/1.2/key-sites
Tutti i parametri possono essere passati con i metodi GET o POST.
Parametri richiesti
api_key
La tua chiave API Akismet. Puoi trovarla nella bacheca del tuo account su: https://akismet.com/account/
Parametri facoltativi
month
Il mese per cui vuoi richiedere il report (ad esempio, 2022‑09
). Come predefinito, c’è il mese corrente.
filter
Filtra i risultati per URL del sito o URL parziale del sito.
Ad esempio, un filtro di “dominio.tld” restituirà l’attività per tutti i siti con “dominio.tld” nel loro URL.
format
Il formato in cui vuoi che vengano restituiti i risultati.
json
(predefinito): restituisce i risultati come valori di JavaScript Object Notation.csv
: restituisce i risultati come valori separati da virgole.
order
La colonna per cui vuoi ordinare i risultati.
total
(predefinito): numero totale di chiamate API (spam + non spam).spam
: ordina per il numero di spam rilevati.ham
: ordina per il numero di non spam che è stato fatto passare.missed_spam
: ordina per il numero di spam non identificati segnalati.false_positives
: ordina per il numero di falsi positivi segnalati.
limit
Il numero massimo di risultati restituiti nel report (predefinito: 500).
offset
L’offset dei risultati restituiti nel report (predefinito: 0).
Esempio in PHP
$data = file_get_contents( 'https://rest.akismet.com/1.2/key-sites?api_key=123YourAPIKey&month=2022-09&format=csv' );
var_dump( $data );
Risultati di esempio (json)
{
"2022-09":[
{
"site":"site6735.domain.tld",
"api_calls":"2072",
"spam":"2069",
"ham":"3",
"missed_spam":"0",
"false_positives":"4",
"is_revoked":false
},{
"site":"site4748.domain.tld",
"api_calls":"1633",
"spam":"3",
"ham":"1630",
"missed_spam":"0",
"false_positives":"0",
"is_revoked":true
}
],
"limit": 10,
"offset": 0,
"total": 2
}
Risultati di esempio (csv)
Siti attivi per 123YourAPIKey durante 2022-09 (limite: 10, offset: 0, totale: 4)
Sito,Chiamate API totali,Spam,Non spam,Spam mancati,Falsi positivi,Revocato
site6735.domain.tld,14446,33,13,0,9,false
site3026.domain.tld,8677,101,6,0,0,false
site3737.domain.tld,4230,65,5,2,0,true
site5653.domain.tld,2921,30,1,2,6,false
Chiavi dei risultati
site
L’hostname del sito che effettua la query all’API usando la tua chiave API.
api_calls
Il numero totale di chiamate API (spam + non spam) effettuate dal sito nel mese richiesto.
spam
Il numero di volte in cui Akismet ha restituito true
per lo spam nel mese richiesto.
ham
Il numero di volte in cui Akismet ha restituito false
per lo spam nel mese richiesto.
missed_spam
Il numero di segnalazioni di spam non individuato inviate dal sito nel mese richiesto.
false_positives
Il numero di segnalazioni di falsi positivi inviate dal sito nel mese richiesto.
is_revoked
Indica se al sito è stato impedito di usare la tua chiave API o meno.
limit
Il numero massimo di risultati restituiti nel report. Può essere impostato usando il parametro limit.
offset
L’offset dei risultati restituiti nel report. Può essere impostato usando il parametro offset.
total
Il numero totale di siti che usano la chiave API nel mese richiesto.
Siamo qui per aiutarti
Se sei difficoltà o hai bisogno di aiuto, non esitare a contattarci.