Hi Joe. Thanks for sharing your thoughts. Exposing REST APIs and the underlying contract kind of goes hand in hand. This is the first API I have stumbled upon, that restricts access to the contract. There is great tool support for generating client code in most flavors of most programming languages. And your html documentation seems to be generated based on a swagger document. So depending on how much of the API we need to integrate with, it might be worth while for me to build a reverse engineering tool to read your documentation and build the swagger myself. That way I am sure that nothing gets lost in the copy/paste/translate to java process. How do other clients integrate with your APIs? Do they copy/paste snippets of code from the documentation? Regards Preben
... View more