Engineering the Future of Software
29–31 Oct 2018: Tutorials & Conference
31 Oct–1 Nov 2018: Training
London, UK

Mapping a domain model to a RESTful web API

Tom Hofte (Xebia), Marco van der Linden (Xebia)
9:0012:30 Wednesday, 31 October 2018
Integration architecture
Location: Windsor Suite
Secondary topics:  Case Study, Hands-on
Average rating: ***..
(3.40, 5 ratings)

Who is this presentation for?

  • Integration architects, application architects, and consultants

Prerequisite knowledge

  • A basic understanding of REST

Materials or downloads needed in advance

  • A laptop

What you'll learn

  • Learn how to model domain behavior to a RESTful API
  • Gain experience designing a RESTful API for a fictional case


Doing business digitally means that having a web API has become a key asset for many companies. A web API, like a website, is a channel into the business domain. It extends a company’s business beyond traditional boundaries and can act as a true market differentiator. REST—based around resources accessed by simple HTTP CRUD operations—is still the de facto standard for designing web APIs because of its HTTP-based characteristics, such as interface uniformity, client-server decoupling, and web scalability. However, translating often complex business domain behavior to simple REST CRUD concepts is not easy. REST resource modeling is therefore a key activity in the API development process and should get sufficient attention in order to get to a consumer-friendly and evolvable web API.

Tom Hofte and Marco van der Linden share practical solutions on how to model domain behavior to a RESTful API, based on DDD concepts and drawn from their own experiences in the field. You’ll have the opportunity to practice in teams with designing a RESTful API for a fictional case and will leave with applied design skills, practical solutions for complex domain to REST mappings, and a better understanding about the choices to be made when designing an API .

Photo of Tom Hofte

Tom Hofte


Tom Hofte is an IT architect at Xebia. Tom has been working as a lead architect in IT for more than 10 years, focusing on integration architectures and distributed system design. He began his career as a developer and over the years has taken on a number of roles within project teams, giving him a deep knowledge and understanding of IT technology and delivering IT projects throughout the complete lifecycle, from concept to grave.

Photo of Marco van der Linden

Marco van der Linden


Marco van der Linden is a Netherlands-based IT solutions architect and consultant at Xebia. Marco has more than 15 years’ experience in IT. Previously, he was at IBM and consulted for multiple companies. He’s worked on all kinds of systems using various technologies but is especially interested in distributed systems design. He hosts meetups on RESTful API design, microservices design, and reliability engineering and leads DASA DevOps training. In his spare time, Marco likes to take long walks with his family, do a bit of fencing (épée), and read books.

Comments on this page are now closed.


Picture of Tom Hofte
31/10/2018 16:09 GMT


Thank you for attending our tutorial this morning. We had a great time discussing how to bridge the gap between a domain and a RESTful API serving as a business channel into your domain. I hope you enjoyed the tutorial as well.

The slides are available at link:

Feel the leave us any feedback about the tutorial. We always look for motivation to continue on this topic and improve it further!

Regards & have a safe trip home,

Tom en Marco