Actividad de la clave y los sitios
Un endpoint para realizar un seguimiento de los sitios que están utilizando tu clave de API de Akismet.
https://rest.akismet.com/1.2/key-sites
Todos los parámetros se pueden pasar mediante los métodos GET o POST.
Parámetros necesarios
api_key
Tu clave de API de Akismet. Puedes encontrarla en el escritorio de tu cuenta en https://akismet.com/account/
Parámetros opcionales
month
El mes del que te gustaría obtener el informe (por ejemplo, 2022‑09
). Por defecto es el mes actual.
filter
Filtrar los resultados por URL del sitio o URL parcial del sitio.
Por ejemplo, un filtro de «dominio.tld» devolverá la actividad de todos los sitios con «dominio.tld» en su URL.
format
El formato en el que te gustaría que se devuelvan los resultados.
json
(por defecto): devuelve los resultados como valores de JavaScript Object Notation.csv
: devuelve los resultados como valores separados por comas.
order
La columna por la que te gustaría que se ordenen los resultados.
total
(por defecto): número total de llamadas a la API (spam + falsos positivos).spam
: ordenar por el número de spam detectado.ham
: ordenar por el número de falsos positivos.missed_spam
: ordenar por el número de spam no detectado reportado.false_positives
: ordenar por el número de falsos positivos reportados.
limit
El número máximo de resultados devueltos en el informe (por defecto, 500).
offset
El offset de los resultados devueltos en el informe (por defecto, 0).
Ejemplo en PHP
$data = file_get_contents( 'https://rest.akismet.com/1.2/key-sites?api_key=123YourAPIKey&month=2022-09&format=csv' );
var_dump( $data );
Resultados de muestra (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
}
Resultados de muestra (csv)
Active sites for 123YourAPIKey during 2022-09 (limit:10, offset: 0, total: 4)
Site,Total API Calls,Spam,Ham,Missed Spam,False Positives,Is Revoked
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
Claves de resultados
site
El nombre de host del sitio que consulta la API utilizando tu clave de API.
api_calls
El número total de llamadas a la API (spam + falsos positivos) que el sitio ha realizado en el mes consultado.
spam
El número de veces que Akismet ha devuelto true
en spam en el mes consultado.
ham
El número de veces que Akismet ha devuelto false
en spam en el mes consultado.
missed_spam
El número de informes de spam no detectados enviados por el sitio en el mes consultado.
false_positives
El número de informes de falsos positivos enviados por el sitio en el mes consultado.
is_revoked
Indica si el sitio tiene revocado el acceso a tu clave de API o no.
limit
El número máximo de resultados devueltos en el informe. Se puede establecer utilizando el parámetro limit.
offset
El offset de los resultados devueltos en el informe. Se puede establecer utilizando el parámetro offset.
total
El número total de sitios que utilizan la clave de API en el mes consultado.
Estamos aquí para ayudarte
Si te bloqueas o necesitas ayuda para solucionar algo, no dudes en ponerte en contacto con nosotros.