Gem wrapper for fraudrecord.com.
[] (http://travis-ci.org/seanhandley/fraudrecord)
Installing
gem install fraudrecord
or
(in Gemfile or .gemspec)
gem 'fraudrecord'
then
require 'fraudrecord'
Usage
First, you will need to create an account on https://www.fraudrecord.com and make a reporter profile. This will create an API key for you. Expose this to your Ruby runtime in the form of an environment variable i.e.
export FRAUD_RECORD_API_KEY=f656a57c78
Secondly, call the query
method with a Ruby hash of parameters containing the data you wish to query. This will automatically be salted and hashed before being submitted to Fraud Record.
Fraudrecord.query name: 'Billy Jones', email: 'billy@fraudsters.com'
=> {:value=>30, :count=>3, :reliability=>8.2, :report=>"https://www.fraudrecord.com/api/?showreport=2bbf78f6f8"}
Fraud Record accepts variables as long as the variable name consists of [a-z] characters, 16 characters max. Uppercase variables will be converted to lowercase internally. The dash (hyphen) character is also accepted. For example, "paypal-email" is a valid variable name.
There is also a common set of accepted variables to choose from:
Variable Name | Description |
---|---|
name | Client name. |
password | Client password. Usually a good indicator of identity. |
company | Company name which the client inputs. |
Client's email address. | |
address | Client's postal address. |
phone | Client's phone number. |
ip | Client's registration IP address. |
hostname | Hostname for server clients. |
accountuser | Hosting account username. |
accountpass | Hosting account password. |
domain | Domain name of the hosting client. |
payment | Payment processor identification, e.g. paypal email address |
ccname | Name on credit card |
ccnumber | Credit card number. |
To learn more, please read https://www.fraudrecord.com/developers.