APIs come in many different styles and types. Before running into a style we need to understand the different options and the trade offs that we are making.