README.md

# Exkismet

Exkismet is a simple Elixir client for the Akismet.com spam detection API.  

## Installation

The package can be installed as:

  1. Add exkismet to your list of dependencies in `mix.exs`:

        def deps do
          [{:exkismet, "~> 0.0.2"}]
        end

  2. Ensure exkismet is started before your application:

        def application do
          [applications: [:exkismet]]
        end

## Configuration

  1. Add the following line to your `config.exs` file:

      `config :exkismet, key: "<your api key>", blog: "http://<yourhosturl>"`


## Test
```
   iex -S mix
   iex(1)> Exkismet.Api.verify
   :valid
   iex(2)>
```
## Checking for spam
```
  Exkismet.Api.comment_check(%{...})  
```
  returns `:ham`, if the comment appears to be ok, `:spam` if it's suspicious, and
  `:discard` if Akismet is 100% certain that it's looking at spam.

## Reporting spam
```
  Exkismet.Api.submit_spam(%{...})
```
## Reporting ham (non-spam)
```
  Exkismet.Api.submit_ham(%{...})
```