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 