Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    akismet-apipublic

    Akismet-api

    Build Status Dependency Status Download Count License

    Full Nodejs bindings to the Akismet (https://akismet.com) spam detection service.

    Features:

    • Promise and callback support
    • Supports all active versions of node (4 to 9)
    • Supports all Akismet API features
    • Uses a modern HTTP client
    • Complete test suite
    • No coffeescript

    Upgrading to 4.0? You likely don't need to change anything, but check out the changelog.

    Installing

    npm install akismet-api

    Creating the Client

    The blog and key values are required by Akismet. There are a set of other avaliable default options visible in the source, but you likely will not need to change those.

    var akismet = require('akismet-api');
    var client = akismet.client({
      key  : 'myKey',                   // Required!
      blog : 'https://myblog.com'       // Required!
    });

    Promises and Callbacks

    All of the function methods below support both promises and callbacks! The returned promises use the Bluebird promise library. The following documentation primarily uses the callback version, but to return a promise simply don't provide a callback. Here is an example of the promise version of the verifyKey() function:

    client.verifyKey()
    .then(function(valid) {
      if (valid) console.log('Valid key!');
      else console.log('Invalid key!');
    })
    .catch(function(err) {
      console.log('Check failed: ' + err.message);
    }):

    Verifying your Key

    It's a good idea to verify your key before use. If your key returns as invalid, the error field will contain the debug help message returned by Akismet.

    client.verifyKey(function(err, valid) {
      if (err) console.log('Error:', err.message);
      if (valid) console.log('Valid key!');
      else console.log('Invalid key!');
    });

    Checking for Spam

    The user_ip, user_agent, and referrer are required options. All other options are optional, but will provide you with better spam detection accuracy.

    client.checkSpam({
      user_ip : '123.123.123.123',              // Required!
      user_agent : 'MyUserAgent 1.0 Webkit',    // Required!
      referrer : 'https://google.com',          // Required!
      permalink : 'https://myblog.com/myPost',
      comment_type : 'comment',
      comment_author : 'John Smith',
      comment_author_email : 'john.smith@gmail.com',
      comment_author_url : 'https://johnsblog.com',
      comment_content : 'Very nice blog! Check out mine!',
      is_test : true // Default value is false
    }, function(err, spam) {
      if (err) console.log ('Error!');
      if (spam) {
        console.log('OMG Spam!');
      } else {
        console.log('Totally not spam');
      }
    });

    Submitting False Negatives

    If Akismet reports something as not-spam, but it turns out to be spam anyways, we can report this to Akismet via this API call.

    client.submitSpam({
      user_ip : '123.123.123.123',              // Required!
      user_agent : 'MyUserAgent 1.0 Webkit',    // Required!
      referrer : 'https://google.com',          // Required!
      permalink : 'https://myblog.com/myPost',
      comment_type : 'comment',
      comment_author : 'John Smith',
      comment_author_email : 'john.smith@gmail.com',
      comment_author_url : 'https://johnsblog.com',
      comment_content : 'Very nice blog! Check out mine!',
      is_test : true // Default value is false
    }, function(err) {
      if (!err) {
        console.log('Spam reported!');
      }
    });

    Submitting False Positives

    If Akismet reports something as spam, but it turns out to not be spam anyways, we can report this to Akismet via this API call.

    client.submitHam({
      user_ip : '123.123.123.123',              // Required!
      user_agent : 'MyUserAgent 1.0 Webkit',    // Required!
      referrer : 'https://google.com',          // Required!
      permalink : 'https://myblog.com/myPost',
      comment_type : 'comment',
      comment_author : 'John Smith',
      comment_author_email : 'john.smith@gmail.com',
      comment_author_url : 'https://johnsblog.com',
      comment_content : 'Very nice blog! Check out mine!',
      is_test : true // Default value is false
    }, function(err) {
      if (!err) {
        console.log('Non-spam reported!');
      }
    });

    Testing

    cd node_modules/akismet-api
    npm test

    Credits

    Author and maintainer is Chris Foster. Development was sponsored by Two Story Robot.

    License

    Released under the MIT license.

    See LICENSE.txt for more information.

    install

    npm i akismet-api

    Downloadsweekly downloads

    786

    version

    4.1.0

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar