I wish i had better docs for foreman. I have not even the minimum to interact with the api.
I had to write a 50 line long error errorparser (mostly if else cases, 20 lines are only related to normalising errors and does only process the body of the response)
At least they started to improve. But im missing anything package and contentview related. We are using satellite, which is an redhat supported packaged form of foreman.
My main problems are:
1. There is no way of detecting or getting info if an resource is locked, our approach is trial and error, which just is too errorprone.
2. errormessages: most errormessages are in the form {displayname: string, error:[string, ]}
sometimes error is errors or the list containing strings is an complex object. Some errors have even two very different ways of error output(permission error)
we are using python for developing our tools.