added API resources

while everybody is talking about the magic of apis, nobody actually tried to reference examples or outlined a first draft. so here are some awesome resources  about api design and a tool to build a well documented api.