Feature/api specs

@myabc Okay, point taken. I'll change it.