Publish the documentation (perhaps through WADL) for the AGS and Portal REST API and Portal API so it can be accessed programmatically, allowing scripting clients, for example in Python, to be generated automatically from that documentation.
For example, the SUDS client library (
https://fedorahosted.org/suds/) allows a developer to generate Python SOAP clients from a published WSDL. It would be great if such a mechanism could be implemented for the AGS & Portal REST API's