RESTful Web API Design

Friday, September 18, 2015 by Rainer Stropek

Yesterday I did a workshop at the Software Architecture Summit in Berlin. More than 60 software architects came to my sessions about RESTful Web API Design. In this blog article I share my slides, code, and links to tools/technologies I mentioned. I hope you find the resources useful.

Agenda

Here is the agenda describing what I covered in the workshop:

RESTful Web APIs have become an integral part of modern software packages. They are important for integration scenarios in enterprises and in the cloud. This workshop is dedicated to designing RESTful Web APIs. Rainer Stropek, himself founder a SaaS-focused company, will guide you through the world of RESTful APIs. In particular, Rainer will speak about the following topics:

  • Short recap of the basic principles of RESTful Web APIs
  • Real-world RESTful API design (e.g. addressing in multi-tenant systems, versioning, long-running operations, etc.)
  • Authentication and authorization with OAuth2 and OpenID Connect
  • The OData standard for RESTful APIs
  • The role of metadata using the examples of http://swagger.io/ and OData
  • Securing and operating RESTful APIs using the example of Azure API Management
  • Code samples using Node.js with JavaScript and CoreCLR with C#

Slides

Here you can view the slides online. Those who prefer downloading a PDF version including hyperlinks can find the PDF document here.

Code

The workshop did not focus on coding. However, to illustrate some priciples I showed simple coding examples. You can find all of them in my Github Samples repository. Here are the links:

Important Resources

Here are links to tools and technologies I showed or mentioned during the workshop:

comments powered by Disqus

Rainer Stropek

Rainer Stropek

Co-founder, architect, developer

Bio

I am co-founder and CEO of the company software architects and have been serving this role since 2008. At software architects my team and I are developing the award-winning SaaS solution time cockpit. Previously, I founded and led IT consulting firms that worked in the area of developing software solutions based on the Microsoft technology stack.

In my work I focus on .NET development and software architecture. I have written some books and articles on C#, database development, Windows Azure, Windows 8 development, WPF, and Silverlight. Regularly I speak at conferences, do workshops and conduct trainings in Europe and the US. Since 2010 I have been MVP for Windows Azure.

I graduated the Higher Technical School Leonding (AT) for MIS with honors and hold a BSc (Hons) Computer Studies of the University of Derby (UK).

Contact

Twitter: @rstropek
Facebook
Google+
Xing
LinkedIn

Authors