The whole spec is there on GitHub for your perusal and criticism, though. https://github.com/appdotnet/api-spec