Which API documentation file best describes the request responses (GET, POST,...)

[Int-Circuit]

Hello everyone,

I am currently building a software/middleware called PartDB-Driver to allow Part-DB to communicate with serial devices.
So far, I have implemented all API request (mostly) completely. What I'm currently trying to do is add a "dictionary" feature for the request's responces.
This would mean basically this:

1. When a request is executed, output is converted from raw text to JSON thanks to cJSON library.
2. after that, JSON output contents is compared to a dict.json file. This one is currently obtained from GET'ing the docs.jsonopenapi and stripping everything except the component.schema array.
3. If the output matches a property from the correct class (ex: "part" request output has a storage location property -> see that this property is present in the dictionary entry) then the value is saved in a response struct for later use on future requests if needed (example consulting a part and then editing features of that part (amount stocked,names, etc..)).

Problem is that the *jsonapi requires post-processing and uses $ref tags. While I understand the use of the later to prevent duplication of api description, cJSON doesn't seems to understand $ref tags (or I missed something).

My question is the following: Is there a API doc file that easily documents all requests responses and in an mostly parse-able format that's better than the jsonopenapi file?

Thanks in advance for the help