New WSO2 White Paper Examines Best Practices for RESTful API Development

White paper discusses how to strengthen API design, evolution and connection by applying RESTful tooling in conjunction with REST constraints and principles

Palo Alto, CA – April 28, 2014 – Today, enterprises are taking advantage of RESTful design to increase API performance, reduce their development efforts, and minimize their operational support burden. However, many API implementations are not truly based on REST constraints and principles. As a result, they lack the expected scalability and interoperability, as well as the ability to evolve. To help address this challenge, WSO2 has published a new white paper that discusses best practices and effective RESTful tooling for designing, evolving and connecting APIs.

Optimizing RESTful Design and Development

The white paper, “REST Easy: API Design, Evolution, and Connection,” was written by WSO2 Vice President of Platform Evangelism Chris Haddad. It begins by defining REST, discussing how RESTful Web services and RESTful APIs have become the standard for consumer and Web-scale enterprise applications. The paper then explores REST constraints that can be applied to create scalable, pervasive and prolific systems. Additionally, it explains how RESTful APIs must conform to REST constraints, resources and representations.

The paper also reviews three significant REST principles: create, read, update, and delete (CRUD) design operations; application behavior modeled as state machines; and hypermedia design. Additionally, it covers how to create easy connections, design APIs that conform to uniform interface and Hypertext As The Engine Of Application State (HATEOAS) conventions, and evolve APIs through versioning, eventing and hypermedia maturity. Finally, the paper examines how organizations can implement RESTful tooling, including Java JAX-RS and API management infrastructure best practices.

About the Author

Chris Haddad, WSO2 vice president of platform evangelism, works closely with developers, architects, and C-level executives to increase WSO2 technology adoption, improve the middleware platform, and maximize customer value. Prior to joining WSO2, Chris led research teams as a research vice president at the Burton Group and Gartner advising Fortune 500 enterprise organizations and technology infrastructure vendors.

About WSO2

WSO2 is the only company that provides a completely integrated enterprise application platform for enabling a business to build and connect APIs, applications, Web services, iPaaS, PaaS, software as a service and legacy connections without having to write code; using big data and mobile; and fostering reuse through a social enterprise store. Only with WSO2 can enterprises use a family of governed secure solutions built on the same code base to extend their ecosystems across the cloud and on mobile devices to employees, customers and partners in anyway they like. Hundreds of leading enterprise customers across every sector—health, financial, retail, logistics, manufacturing, travel, technology, telecom and more—in every region of the world rely on WSO2’s award-winning, 100% open source platform for their mission-critical applications. To learn more, visit or check out the WSO2 community on the WSO2 Blog, Twitter, LinkedIn, Facebook, and FriendFeed..