Did you try using JSON Hyper Schema for defining APIs maybe?