We are using https://hjson.org/ to describe metadata of xml/json API and how to parse the result. It solves all the problems mentioned in the post.