Closed tmarrs closed 9 years ago
Similar to what I just said in the other RESTful proposal, I think by the percentage of folks using a given technology, we should lead with thinking about https://github.com/DOSUG/feedback/issues/8 as JSON is the "it is everywhere!" thing right now. What say you @DOSUG/boardmembers ?
You’ve been working with RESTful Web Services for a few years now, and you’re looking to improve your design. Maybe you're new to REST on your project. In any case, you have questions: • How do I design a quality Service? • Are there any guidelines and best practices for RESTful API design? • How can I tell if a Web Service is truly RESTful? • Where can I find well-designed RESTful APIs? • Are there any patterns and best practices for designing my RESTful Web Service?
In this presentation, we’ll cover:
RESTful Web Service 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 API
Available RESTful Web Service Guidelines • Atlassian • Alfresco
Well-Designed RESTful APIs • Twitter • LinkedIn • Open Library • Twilio
RESTful API Repositories • Programmable Web • APIhub
Service Architecture Layers
Service Design Patterns • Client-Side o Gateway o Service Stub o Mapper • Request Mapper • Response Mapper • Service Interceptor
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 and Node.js. Attendees will gain a solid foundation in RESTful Web Service design.