I am building a client-side product with REST. All user interaction will be done with a browser (the config stuff will be on a server running on localhost). I want everything to be REST compliant, even though the application will be running on a client's machine on localhost and will never be accessible from the outside.

The commands are pretty simple:

  • update
  • restart
  • sync

Here's what I've come up with:

  • POST to / with 'action' parameter (JSON) detailing specifics
  • PUT a new resource
    • subsequent GET requests will return the status
    • when the command is complete, the resource is deleted

What would be the most RESTful way to implement this?

Note:

I'm not asking for scrutinization of my software architecture. I have reasons for choosing a REST interface instead of a unix domain socket, CLI interface, or even a regular GUI interface. The justification would overcomplicate the question and make it too localized.

I have had the same need on a couple of different projects (both client only and server) and I am looking for community input on best practices.

Edit
Report