basic spec for a simple web service api to put it all together