Vérification de la clé
La méthode de vérification de la clé valide votre clé avant le premier appel aux méthodes comment-check, submit-spam ou submit-ham. C’est le premier appel que vous devriez effectuer à Akismet ; il est particulièrement utile si plusieurs utilisateurs disposant chacun de leur propre abonnement Akismet utilisent votre application.
Notez qu’il n’est pas nécessaire d’appeler cette méthode avant chaque appel à comment-check, submit-spam ou submit-ham ; vous ne devriez effectuer cette requête que pour confirmer la validité d’une clé API avant de la stocker localement.
Cette méthode est appelée au moyen d’une requête POST à l’URL suivante :
https://rest.akismet.com/1.1/verify-key
Paramètres POST obligatoires
api_key
Votre clé API Akismet. Vous la trouverez sur le Tableau de bord de votre compte à l’adresse https://akismet.com/fr/compte/
blog
La page d’accueil ou l’URL principale de l’instance qui effectue la requête. Pour un blog, un site ou un wiki, il s’agit de la page d’accueil. Remarque : il doit s’agir d’une URI complète, incluant http://.
Exemple PHP
// Call to verify key function
akismet_verify_key('123YourAPIKey', 'http://www.yourblogdomainname.com/');
// Authenticates your Akismet API key
function akismet_verify_key( $key, $blog ) {
$blog = urlencode($blog);
$request = 'api_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 ); // One TCP-IP packet
}
fclose( $fs );
$response = explode( "rnrn", $response, 2 );
}
if ( 'valid' == $response[1] ) {
return true;
} else {
return false;
}
}
Exemple de réponse en cas de succès
L’appel renvoie valid si la clé est valide.
Array (
[0] => HTTP/1.1 200 OK
Server: nginx
Date: Mon, 24 Feb 2014 16:31:55 GMT
Content-Type: text/plain; charset=utf-8
Connection: close
Content-length: 5
[1] => valid
)
Exemple de réponse en cas d’erreur
Si l’appel verify-key renvoie « invalid », il inclut généralement un en-tête HTTP supplémentaire contenant des informations de débogage sur ce qui n’était pas valide dans la requête.
Array (
[0] => HTTP/1.1 200 OK
Server: nginx
Date: Mon, 24 Feb 2014 16:34:54 GMT
Content-Type: text/plain; charset=utf-8
Connection: close
X-akismet-debug-help: We were unable to parse your blog URI
Content-length: 7
[1] => invalid
)
Nous sommes là pour vous aider
Si vous rencontrez un blocage ou avez besoin d’aide pour résoudre un problème, n’hésitez pas à nous contacter.
Akismet 