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.