tulsa-county-inmate-information-center-api

JSON wrapper for tulsa county inmate information center PDF reports.

##Installation This API runs on node.js. It was written against v6.9.1 but should generally be compatible with most node versions.

###Prerequisites

NodeJS

###Running from Source $ git clone https://github.com/codefortulsa/tulsa-county-inmate-information-center-api.git $ cd tulsa-county-desk-blotter-api $ npm install $ node server.js

Note: it is recommended to run the server using a tool like forever to keep it running in the background.

###Heroku

THe API is set up for heroku, to run it all you have to do is add a heroku remote and push to heroku.

##How does it work? When a request is made to the api at http://localhost:3030/deskBlotter, the following PDF is downloaded: http://iic.tulsacounty.org/srsreports/Desk%20Blotter.pdf. The PDF is then processed by pdf2json and the resulting JSON is parsed for the data.

When a request is made to the api at http://localhost:3030/inmateBooking, the following PDF is downloaded: http://iic.tulsacounty.org/expInmateBookings/Export. The PDF is then processed by pdf2json and the resulting JSON is parsed for the data.

Note that PDFs will be cached for a full hour.

##Config

Configuration is loaded using the rc npm module. The easiest way to configure the app is to put a json file at ~/.iic-apirc. The defaults are as follows:

{
  "port": 3030,
  "whitelist": [
    "127.0.0.1",
    "::1"
  ]
}

###Data scrubbing Fields like Name, Address, DOB, and Age are scrubbed from the data unless the request comes from a whitelisted address.

##Live API The live API can be found at http://data.thekinfamily.com/docs/#!/Inmate_Information

pipakin/tulsa-county-inmate-information-center-api

tulsa-county-inmate-information-center-api