Schlüssel-Verifizierung
Mit der Schlüssel‑Verifizierung wird dein Schlüssel authentifiziert, bevor du zum ersten Mal die Methoden comment‑check, submit‑spam oder submit‑ham aufrufst. Dies ist der erste Aufruf, den du an Akismet senden solltest, und er ist besonders nützlich, wenn mehrere Benutzer mit eigenen Akismet‑Abonnements deine Anwendung verwenden werden.
Beachte, dass du diese Methode nicht vor jedem Aufruf an comment‑check, submit‑spam oder submit‑ham aufrufen musst; du solltest diese Anfrage nur stellen, um sicherzustellen, dass ein API‑Schlüssel gültig ist, bevor du ihn lokal speicherst.
Diese Methode wird über eine POST‑Anfrage an die folgende URL aufgerufen:
https://rest.akismet.com/1.1/verify-key
Erforderliche Parameter
api_key
Dein Akismet‑API‑Schlüssel. Du findest ihn in deinem Kontodashboard unter https://akismet.com/account/
blog
Die Startseite oder die URL der Instanz, die die Anfrage stellt. Bei einem Blog oder einem Wiki wäre dies die Startseite. Hinweis: Muss eine vollständige URI sein, einschließlich http://.
PHP-Beispiel
// Aufruf der Schlüsselüberprüfungsfunktion
akismet_verify_key('123IhrAPIKey', 'http://www.ihreblogdomainname.com/');
// Authentifiziert Ihren Akismet-API-Schlüssel
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 ); // Ein TCP-IP-Paket
}
fclose( $fs );
$response = explode( "rnrn", $response, 2 );
}
if ( 'valid' == $response[1] ) {
return true;
} else {
return false;
}
}
Beispiel für eine erfolgreiche Antwort
Der Aufruf liefert die Antwort valid zurück, wenn der Schlüssel gültig ist.
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
)
Beispiel für eine Fehlerantwort
Wenn der Aufruf verify‑key die Antwort invalid liefert, enthält die Antwort normalerweise einen zusätzlichen HTTP‑Header mit einigen Debug‑Informationen darüber, was genau an dem Aufruf ungültig war.
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
)
Wir sind hier, um zu helfen
Wenn du einmal nicht weiterkommst oder Hilfe bei der Problembehandlung benötigst, kannst du uns jederzeit gerne kontaktieren.