Director REST api documentation

The documentation for the director REST api is still very short. Is there somewhere a more extended documentation or a library to use the api. Creating a new host or geting informations about simple objects works fine. But when I try to add new services, servicesets, chage commands and so on, it is very time consuming to find a way to do this. I often get responses, that there are missing ids.
Any insights to the api?