Added initial version of API design specification

Not yet complete, first doc für review purposes. Future design specs shall be pretty similar.
Can we split the descriptions of request and response up please?