Software Engineering
web-services rest cqrs
Updated Thu, 28 Jul 2022 07:09:56 GMT

REST Service and CQRS

I am struggling with architecture on a new project. I am using the following patterns/technology.

  • CQRS - anything going in goes through a command
  • REST - using WebAPI
  • MVC - mvc
  • Angular - building a spa
  • nhibernate

I belive this provides some great separation and should help keep a very complex domain from growing into a giant set of services that mix queries with other business logic.

  • The REST services have become non restful. They are putting methods in rest that are "SearchByDate", "SearchByItem" etc.
  • Service Methods that execute commands are called with a "web" model class, a new command is built in the service and executed, I feel like there is a lot of extra code.

I expected this to be much different but I wasn't around to keep things on track.

Finally my questions are this...

I would have liked to see PUT Person (CreatePersonCommand) but then I realized that isn't restful either is it? the put should be a person entity not a command.

Can I make CQRS and REST service work together or am I going about this all wrong?

How do I handle service methods that don't fit into a REST model. I am not performing CRUD on the object but rather executing some business logic. I.E. I don't want the UI to be responsible for how a shipment is "unshipped" I want the service layer to worry about that.


  • REST works OK with a command model... the commands basically become nouns, or worker resources.

So instead of using


You'd have a "search" (noun) resource


I've always felt that's kind of a word game, but it does has the benefit of keeping your semantics resource oriented.

  • In the case where the verb directly mirrors an HTTP verb, just omit it.

Instead of


it's just PUT to


...the call is the same, it's just that you're using the HTTP verb (PUT) instead of duplicating that in the resource name.

CQRS is about splitting up your writers from your readers. It would be fair game under both CQRS and REST to add some resources that only accept POST -- using the "data processing" clause for POST provided in the HTTP spec. POST data for processing, then GET the resulting resources.

But as long as your resource names boil down to nouns rather than verbs, you can keep all the purists happy.


A Command name is just a combination of action + target. You're concatenating those to create your Command names "ActionTargetCommand".


  • the target goes in the base URI

  • the action becomes the method or else implied from the query string

  • and Command just goes away as redundant

"ACTION htpp://blah/Target?ActionParameter=".

You either need to make your action one of the HTTP methods, or else turn the resource into a processor noun.

One one level, it's just renaming to suit a resource-oriented paradigmn, but on a deeper level is a matter of splitting the commands into those covered by the HTTP methods, and others into processing nouns.

Comments (3)

  • +0 – I think I didn't word the question well... I will update it. I know that I just need person and the verb describes what the action is. what I am missing is how to tie this into commands. — Jun 03, 2014 at 19:51  
  • +0 – I added a little to the answer if that helps. Mainly it's just a slight difference in naming conventions. But it might also have an impact on the implementation. — Jun 03, 2014 at 20:01  
  • +0 – Using nouns isn't really about being a purist. It's about understanding that REST is designed to deal with entities/resources. The verbs are in the HTTP methods (GET, etc.). Therefore, to find a Person by name, you would say /Persons?name="Thomas". This is saying "Give me a list of all Persons whose name is "Thomas". — Dec 30, 2019 at 21:02  

External Links

External links referenced by this document: