Как вы документируете свои rest api?
К примеру en.wikipedia.org/wiki/Web_Application_Description_Language. А для себя (два разработчика, клиент и сервер) google docs выручает, чтобы не заморачиваться.
У меня все REST методы описываются через аннотации (Symfony 2) ну и потом по ним генерится документация. Добавить туда примеры с curl проблемы не составляет.