API v1 spec

This is still a work-in-progress, but any feedback is more than welcome.
maybe add a line like "This hash should be used to refer uniquely to unit files"