We'll put this on a wiki page, but just a few:
GET methods that return a collection should return an empty collection if no entries are found, rather than 404 or 204 and null.
GET methods to return a specific resource should return 404 if no resource is found.
Methods that create a resource should return 201 (Created) on success, providing the link for the resource created. In practice, this will likely mean returning some of type Response.
Methods that either delete or modify a resource should return 200 on success. If the resource is not found, a 404 should be returned.
Revision to 4:
Methods that either delete or modify a resource should return 200/204 on success. 204 is returned when the response has no content (ie. returns void type). This is likely to be the response for DELETE operations. Resteasy should select the right response 200/204 here. If the resource is not found, a 404 should be returned.
master:
Metadata Update from @vakwetu: - Issue assigned to edewata - Issue set to the milestone: 10.1 - 10/13 (October)
Dogtag PKI is moving from Pagure issues to GitHub issues. This means that existing or new issues will be reported and tracked through Dogtag PKI's GitHub Issue tracker.
This issue has been cloned to GitHub and is available here: https://github.com/dogtagpki/pki/issues/1316
If you want to receive further updates on the issue, please navigate to the GitHub issue and click on Subscribe button.
Subscribe
Thank you for understanding, and we apologize for any inconvenience.
Login to comment on this ticket.