Is That REST API Really RPC? Roy Fielding Seems to Think So

by

I think your explanation mostly covers it. URIs are opaque identifiers that should, for the most part, not be communicated beyond the bookmark URI that is used by the user agent to access the app.

As for documenting, this question has been done quite a few times. You document your media type, together with the hyperlink controls that it contains (links and forms), and the interaction model if you so wish (see AtomPub).

If you document the URIs or how to build them, you’re doing it wrong.

More Related Contents:

  1. What exactly is RESTful programming?
  2. Best practices for API versioning? [closed]
  3. If REST applications are supposed to be stateless, how do you manage sessions?
  4. Free Rest API to retrieve current datetime as string (timezone irrelevant) [closed]
  5. Design RESTful query API with a long list of query parameters [closed]
  6. Transactions in REST?
  7. How to QUEUE a new build using VSTS REST API
  8. What is RESTful programming?
  9. How to understand “RESTful API is stateless”?
  10. API pagination best practices
  11. How to use cURL to send Cookies?
  12. RESTful way to create multiple items in one request
  13. Why the slow WADL uptake? [closed]
  14. REST vs JSON-RPC? [closed]
  15. Azure Websites Kudu REST API – Authentication
  16. REST api: requesting multiple resources in a single get [duplicate]
  17. How to format Swagger 2.0 text descriptions?
  18. How should the header X-DocuSign-Authentication be used for REST and SOAP?
  19. How to create new build pipeline using Azure DevOps REST API?
  20. Restful way for deleting a bunch of items
  21. Swagger documentation with JAX-RS Jersey 2 and Grizzly
  22. How one could use server side sorting and paging with Azure Mobile Services
  23. Call a Server-side Method on a Resource in a RESTful Way
  24. RESTful – What should a DELETE response body contain
  25. Place API key in Headers or URL
  26. Curl retry mechanism
  27. The MAC signature found in the HTTP request ‘…’ is not the same as any computed signature
  28. Response status code for searches in REST APIs
  29. Status code when deleting a resource using HTTP DELETE for the second time
  30. Avoid duplicate POSTs with REST

Leave a Comment