3 ms·

I have been trying to get anyone to use it since I discovered FasterXML/Jackson could generate it. I have not worked for an organization with public APIs. Not

I have been trying to get anyone to use it since I discovered FasterXML/Jackson could generate it. I have not worked for an organization with public APIs. Not a single one of the APIs I work on is completely stable. Figuring out what our APIs do requires techniques from archeology, anthropology, and sociology.

avmich 4y ago
I'm not sure, but I suspect the JSON Schema is better used on the problem formulation stage, not on reverse engineering stage. It's still rather simple tool, it can easily be confused and hide the intent - at the same time if you record your API syntax in form of JSON Schema, you at least have reasons for each JSON Schema feature you put into the spec.