Issue #4643 has been updated by James Turnbull. Target version changed from 1.2.0 to 1.x
---------------------------------------- Bug #4643: Web service API should be designed and documented https://projects.puppetlabs.com/issues/4643 Author: Igal Koshevoy Status: Accepted Priority: Normal Assignee: Category: Target version: 1.x Keywords: Branch: Affected URL: Affected Dashboard version: Currently the application provides an incomplete and undocumented API. Unfortunately, various people are beginning to use these. Worse still, the report aggregator and node classifier use these undocumented APIs in incompatible ways across different Puppet releases. Desired behavior: * All actions, parameters and output formats should be documented and examples provided. * All actions that emit data should be able to produce JSON, the preferred format for those working with web services. * All actions that return lists of records should be paginated, e.g. fetching "/reports.json" should return a paginated subset of the reports data, rather than all reports. All paginated actions should emit a consistent field describing the number of pages and records matched. All actions doing pagination should accept a consistent set of parameters to retrieve records for a particular page. Optional behavior: * Authenticity token cookie, as used by Rails, may be used to guard all non-GET actions as long as it's easy to retrieve. * Site-specific token may be used to guard all non-GET actions. -- You have received this notification because you have either subscribed to it, or are involved in it. To change your notification preferences, please click here: http://projects.puppetlabs.com/my/account -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/puppet-bugs?hl=en.
