first pass at full api
updating readme with usage information
filling in my name
secret key support