Schlüssel-/Website-Aktivität
Dies ist ein Endpunkt zum Verfolgen der Websites, die deinen Akismet-API-Schlüssel verwenden.
https://rest.akismet.com/1.2/key-sites
Alle Parameter können über die GET- oder POST-Methoden angegeben werden.
Erforderliche Parameter
api_key
Dein Akismet-API-Schlüssel. Du findest ihn in deinem Konto-Dashboard unter https://akismet.com/konto/
Optionale Parameter
month
Der Monat, für den du den Bericht erhalten möchtest (z. B. 2022-09). Standardmäßig wird der aktuelle Monat verwendet.
filter
Ergebnisse nach Website-URL oder teilweiser Website-URL filtern.
Beispiel: Mit dem Filter „domain.tld“ werden die Aktivitäten aller Websites mit „domain.tld“ in der URL geliefert.
format
Das Format, in dem du die Ergebnisse erhalten möchtest.
json(Standard): Ergebnisse als JavaScript Object Notation-Werte liefern.csv: Ergebnisse als durch Kommas getrennte Werte (CSV) liefern.
order
Die Spalte, nach der die Ergebnisse sortiert werden sollen.
total(Standard): Gesamtzahl der API-Aufrufe (Spam + Kein Spam).spam: Nach der Anzahl der erkannten Spam-Nachrichten sortieren.ham: Nach der Anzahl der zugelassenen Nicht-Spam-Nachrichten sortieren.missed_spam: Nach der Anzahl der gemeldeten übersehenen Spam-Nachrichten sortieren.false_positives: Nach der Anzahl der gemeldeten falsch-positiven Ergebnisse sortieren.
limit
Die maximale Anzahl der in dem Bericht gelieferten Ergebnisse (Standard: 500).
offset
Der Offset der in dem Bericht gelieferten Ergebnisse (Standard: 0).
PHP-Beispiel
$data = file_get_contents( 'https://rest.akismet.com/1.2/key-sites?api_key=123YourAPIKey&month=2022-09&format=csv' );
var_dump( $data );
Beispielergebnisse (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
}
Beispielergebnisse (csv)
Aktive Websites für 123YourAPIKey im September 2022 (Limit: 10, Offset: 0, Gesamt: 4)
Website,Gesamtzahl der API-Aufrufe,Spam,Kein Spam,Verpasster Spam,Falsch positive Ergebnisse,Widerrufen
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
Ergebnisschlüssel
site
Der Hostname der Website, die die API mit deinem API-Schlüssel abfragt.
api_calls
Die Gesamtzahl aller API-Aufrufe (Spam + Kein Spam), die die Website im angefragten Monat getätigt hat.
spam
Die Anzahl der Spam-Meldungen, für die Akismet im angefragten Monat das Ergebnis true geliefert hat.
ham
Die Anzahl der Kein-Spam-Meldungen, für die Akismet im angefragten Monat das Ergebnis false geliefert hat.
missed_spam
Die Anzahl der von der Website im angefragten Monat gemeldeten übersehenen Spam-Nachrichten.
false_positives
Die Anzahl der von der Website im angefragten Monat gemeldeten falsch-positiven Ergebnisse.
is_revoked
Gibt an, ob der Website die Berechtigung zur Nutzung deines API-Schlüssels entzogen wurde oder nicht.
limit
Die maximale Anzahl der im Bericht gelieferten Ergebnisse. Kann mit dem limit-Parameter festgelegt werden.
offset
Der Offset der im Bericht gelieferten Ergebnisse. Kann mit dem offset-Parameter festgelegt werden.
total
Die Gesamtzahl der Websites, die den API-Schlüssel im angefragten Monat verwenden.
Wir sind hier, um zu helfen
Solltest du einmal nicht weiterkommen oder Hilfe bei der Problembehandlung benötigen, kannst du uns jederzeit gerne kontaktieren.
Akismet 