Rest APIs have to be documented. It is suggested to use framework like swagger (http://swagger.io/) or something similar. See http://www.mdeforge.org/?page_id=68