You should look into Hypermedia API's. The entire point is to have a discoverable API where the developer doesn't need to know low level details. Theoretically, you could write a library to parse, adapt, and act on another API.

http://stackoverflow.com/questions/15214526/why-hypermedia-a...