Vérification de clé

La vérification de clé authentifie votre clé avant d’appeler les méthodes comment‑check, submit‑spam ou submit‑ham pour la première fois. C’est le premier appel que vous devez faire à Akismet et il est particulièrement utile si vous avez plusieurs utilisateurs avec leurs propres abonnements Akismet utilisant votre application.

Notez que vous n’avez pas besoin d’appeler cette méthode avant chaque appel à comment‑check, submit‑spam ou submit‑ham ; vous ne devez faire cette demande que pour confirmer qu’une clé API est valide avant de la stocker localement.

Cette méthode est appelée via une requête POST à l’URL suivante :

https://rest.akismet.com/1.1/verify-key

Paramètres obligatoires

api_key
Votre clé API Akismet. Vous pouvez la trouver sur votre tableau de bord de compte à https://akismet.com/account/

blog
L’URL de la page d’accueil ou de la page d’accueil de l’instance qui effectue la demande. Pour un blog, un site ou un wiki, il s’agirait de la page d’accueil. Remarque : doit être un URL complet, y compris http://.

Exemple en PHP

// Appel de la fonction de vérification de clé
akismet_verify_key('123YourAPIKey', 'http://www.yourblogdomainname.com/');

// Authentifie votre clé API Akismet
function akismet_verify_key( $key, $blog ) {
    $blog = urlencode($blog);
    $request = 'key='. $key .'&blog='. $blog;
    $host = $http_host = 'rest.akismet.com';
    $path = '/1.1/verify-key';
    $port = 443;
    $akismet_ua = "WordPress/4.4.1 | Akismet/3.1.7";
    $content_length = strlen( $request );
    $http_request  = "POST $path HTTP/1.0rn";
    $http_request .= "Host: $hostrn";
    $http_request .= "Content-Type: application/x-www-form-urlencodedrn";
    $http_request .= "Content-Length: {$content_length}rn";
    $http_request .= "User-Agent: {$akismet_ua}rn";
    $http_request .= "rn";
    $http_request .= $request;

    $response = '';
    
    if( false != ( $fs = @fsockopen( 'ssl://' . $http_host, $port, $errno, $errstr, 10 ) ) ) { 
        fwrite( $fs, $http_request );

        while( !feof( $fs ) ) {
            $response .= fgets( $fs, 1160 ); // Un paquet TCP-IP
        }
    
        fclose( $fs );

        $response = explode( "rnrn", $response, 2 );
    }
 
    if ( 'valid' == $response[1] ) {
        return true;
    } else {
        return false;
    }
}

Exemple de réponse réussie

L’appel renvoie valid si la clé est valide.

Tableau (
    [0] => HTTP/1.1 200 OK
           Serveur: nginx
           Date: Lun, 24 Fév 2014 16:31:55 GMT
           Type de contenu: texte/plain; charset=utf-8
           Connexion: close
           Longueur du contenu: 5
    [1] => valide
)

Exemple de réponse d’erreur

Si l’appel verify‑key renvoie invalid, il inclut généralement un en‑tête HTTP supplémentaire avec des informations de débogage sur ce qui était exactement invalide dans l’appel.

Tableau (
    [0] => HTTP/1.1 200 OK
           Serveur: nginx
           Date: Lun, 24 Fév 2014 16:34:54 GMT
           Type de contenu: texte/plain; charset=utf-8
           Connexion: close
           X-akismet-debug-help: Nous n'avons pas pu analyser l'URI de votre blog
           Longueur du contenu: 7
    [1] => invalide
)

Nous sommes là pour vous aider

Si vous êtes bloqué ou avez besoin d’aide pour résoudre un problème, n’hésitez pas à nous contacter.