Creazione della tua applicazione

Se decidi di scrivere un’integrazione personalizzata, ci sono alcuni aspetti da tenere a mente:

  1. Per interagire correttamente con l’API di Akismet, la tua applicazione dovrebbe offrire un modo per segnalare lo spam non rilevato e i falsi positivi, oltre a effettuare i controlli dei commenti.
  2. Più dati invii con ogni controllo dei commenti, maggiori sono le probabilità che Akismet eviti spam non rilevato e falsi positivi.

Struttura delle chiamate API

Tutte le chiamate ad Akismet sono richieste POST, simili a quelle inviate da un modulo web. Le variabili della richiesta vanno costruite come una query string, key=value, con più variabili separate da e commerciali. Non dimenticare di codificare i valori in formato URL.

Tipi di chiamate API

Esistono tre diversi tipi di chiamate ad Akismet:

  1. La verifica della chiave consente di controllare se la chiave API in uso è valida. È particolarmente utile se la tua applicazione sarà utilizzata da più utenti, ciascuno con il proprio abbonamento Akismet.
  2. Il controllo dei commenti serve per chiedere ad Akismet se un determinato articolo, commento o profilo è spam.
  3. Segnala spam e Segnala non spam sono chiamate di follow-up per comunicare ad Akismet eventuali errori (spam non rilevato e falsi positivi). Sono molto importanti: non dovresti sviluppare con l’API di Akismet senza prevedere la possibilità di segnalare spam non rilevato e falsi positivi.

Test delle chiamate API

Akismet funziona esaminando tutte le informazioni disponibili nel loro insieme. Non è sufficiente fornire solo il contenuto di un messaggio: devi includere il maggior numero possibile di dati indipendenti in ogni chiamata. Pertanto, prima di poter testare l’accuratezza di Akismet, assicurati di inviare informazioni complete e corrette.

Per simulare un risultato di spam, effettua una chiamata all’API comment-check impostando comment_author su akismet-guaranteed-spam oppure comment_author_email su akismet-guaranteed-spam@example.com. Compila tutti gli altri campi richiesti con valori tipici. L’API di Akismet restituirà sempre una risposta true per una richiesta valida contenente uno di questi valori. Se ricevi una risposta diversa, c’è un problema nel tuo client, nei dati o nella comunicazione.

Per simulare un risultato di non spam, effettua una chiamata all’API comment-check impostando user_role su administrator e compilando tutti gli altri campi richiesti con valori tipici. L’API di Akismet restituirà sempre una risposta false. Qualsiasi altra risposta indica un problema nei dati o nella comunicazione.

Assicurati inoltre che il tuo client gestisca correttamente risposte impreviste. Non dare per scontato che l’API comment-check restituisca sempre true o false. Una richiesta non valida può generare una risposta di errore; informazioni aggiuntive saranno di solito disponibili nelle intestazioni HTTP. Naturalmente, un problema di connettività può non produrre alcuna risposta. È importante non interpretare erroneamente una risposta non valida come indicazione di spam o non spam.

Per i test automatizzati, includi il parametro is_test=1 nelle tue richieste di test. In questo modo Akismet non modificherà il proprio comportamento in base a tali chiamate API, che non avranno alcun effetto sull’addestramento. I test saranno quindi ripetibili fino a un certo punto, nel senso che un test non influenzerà quelli successivi.

Impostazione dello user agent

Se possibile, fai in modo che la stringa user agent segua sempre questo formato:

Application Name/Version | Plugin Name/Version

La stringa user agent del plugin Akismet per WordPress è la seguente:

WordPress/4.4.1 | Akismet/3.1.7

Tipi di applicazione

Akismet può essere utilizzato per filtrare qualsiasi tipo di contenuto generato dagli utenti, ma la documentazione dell’API è stata originariamente scritta per moduli di commento e forum. Se stai sviluppando un modulo di contatto, consulta queste indicazioni aggiuntive sull’uso di Akismet con il modulo di contatto.