Speaker Topics - No Fluff Just Stuff

RESTful Design at Work

looking to improve your design. Maybe you're new to REST on your project. In any case, you have questions:

  • Are there any guidelines and best practices for RESTful API design?
  • How can I tell if a Web Service is truly RESTful?
  • How do I design a quality Service?
  • Where can I find well-designed RESTful APIs?
  • Are there any design patterns and best practices for designing my RESTful Web Service?
  • What REST Frameworks are available?

In this presentation, we’ll cover:

RESTful API Design Best Practices


  • Of Nouns and Verbs
  • When to use Parameters
  • Pagination
  • Searching
  • Versioning
  • Content Negotiation
  • Error Handling
  • JSON Object Design
  • How to spot a Hybrid Service

Documenting Your RESTful API


  • Swagger
  • IODocs
  • Restdoclet
  • Apiary.io

Available RESTful Web Service Guidelines


  • Atlassian
  • Alfresco

Well-Designed RESTful APIs


  • Twitter
  • LinkedIn
  • Open Library
  • Twilio

RESTful API Repositories


  • Programmable Web
  • webshell

Service Architecture


  • Web Apps and Web Services
  • Layers
    ++ API
    ++ Business
    ++ Data/Integration

Service Design Patterns


  • Gateway
  • Service Stub
  • Request Mapper
  • Response Mapper
  • Service Interceptor

REST Frameworks


  • Java:
    ++ Restlet
    ++ RESTEasy
    ++ Apache CXF
    ++ Spring MVC
  • Node.js:
    ++ Express

Example Code


  • Spring MVC

We will look at a single business problem to design a RESTful Web Service. Along the way, we'll walk through several well-known RESTful Web Service APIs and show some examples with Spring MVC. Attendees will gain a solid foundation in RESTful Web Service design.


About Tom Marrs

Tom Marrs is a Technical Architect at Perficient, where he specializes in RESTful Web Services and Service-Oriented Architecture (SOA). He designs and implements mission-critical web and business applications using the latest SOA, Ruby on Rails, JSON, HTML5, JavaScript, Java/EE, and Open Source technologies.

Tom is the author of the JSON Refcard for DZone, and the upcoming book, JSON at Work for O’Reilly. Tom is also a speaker at the Great Indian Developer Summit (GIDS) conference.

An active participant in the local technical community, Tom helps emcee at the HTML5 Denver User Group, helped found the Denver Open Source User Group (DOSUG), has served as President of the Denver Java Users Group (DJUG), and speaks at other local user groups.

More About Tom »