Designing and building RESTful APIs isn’t easy. On its surface, it may seem simple – after all, developers are only marshaling JSON back and forth over HTTP, right? Believe it or not, that’s only a small part of the equation. There are many things to keep in mind while building the systems that act as the key to your system.

In this session, we’ll delve into several best practices to keep in mind when designing your RESTful API. Attendees will learn about authentication, versioning, controller/model design, testability, documentation and change management. This session will also explore the do’s and don’t’s of RESTful API management so that you make sure your APIs are simple, consistent, and easy-to-use.

Examples will be done using ASP.NET Web API and C#. However, this session will benefit anyone who is or might be working on a RESTful API.

Based on RESTful API Best Practices and Common Pitfalls


Thanks NDC Conferences for recording and publishing!

Never RESTing – RESTful API Best Practices using ASP.NET Web API - Spencer Schneidenbach from NDC Conferences on Vimeo.

Download Slides

Presented at

Chicago Code Camp 2016
Kansas City Developer Conference 2016
Music City Code 2016
New York Code Camp 2016
DevUp 2016
NDC London 2017

Further Reading

Microsoft REST API Guidelines
White House’s guide on RESTful APIs
Paging in ASP.NET Web API
OData Web API Github
HTTP API Design Guide
Azure team’s API Implementation guidance
Building and Securing a RESTful API for Multiple Clients in ASP.NET – Pluralsight course