public
Description: Ruby interface to the IDology API
Homepage:
Clone URL: git://github.com/pdsphil/ruby-idology.git
pdsphil (author)
Tue Feb 26 20:00:10 -0800 2008
commit  7933d08325be46cfece5c9ea0b8bf35b5125c7cf
tree    02a893c7577625668932fc14383d295804db5a83
parent  b7fbddef94873c4746574cb137e34dadd22744d0
ruby-idology / README
100644 28 lines (15 sloc) 1.605 kb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
== Notes
 
This code has come straight from a production Rails app. It will soon be a Rails plugin, but for now, I suggest putting it in the lib/ directory of your Rails project.
 
You must have a valid IDology account to test or use this API library.
 
== ID Verification via IDology
 
Assuming you have a local proxy setup to the development server - and the development server's IP is authorized to access the IDology API - here is a curl command to test whether or not the API is working correctly. In this example, the socks v5 proxy is using 'ssh -D localhost:1080' to setup a temporary proxy between the development machine and the development server. Note that the username / password must be correct.
 
This curl command will perform a search for 'Mickey Mouse' - a valid test record in the IDology system
 
curl -v --socks http://127.0.0.1:1080 -d username=test -d password=test -d firstName=mickey -d lastName=mouse -d address='15 MIDLAND AVE APT' -d city=paramus -d state=NJ -d zip=07652 https://web.idologylive.com/api/idlive.svc
 
 
== Configuration
 
The id_verification directory must contain a file called 'config.yml' using the following format:
 
# IDology API username and password
username: your_api_username
password: your_api_password
 
It is recommended that you symlink this file to the directory after deploy for security reasons. This file is also required for development mode - just fill with dummy data.
 
== Tests
 
To run the rspec tests, make sure you are in the lib/api/id_verification directory and type 'spec -cfs spec/' - these tests do not hit the API directly, they use fixtures.