Nice writeup. But I don't see what AI has to do with this. You defined and used nice translators from JSON API specs into REST calls and documents. There are a few tools for that RAML, etc. Computer Science is historically great at "precise" language based translations. I don't think that's the best place for AI.