API designers have several documentation formats to choose from. RAML, a recently open-sourced API documentation format adopts a contract-first approach which has become the favoured model for API design. The RAML language also includes constructs that help reduce duplication inherent in other formats. This article steps through a simple API design to illustrate some of RAML's DRY features.
As mobility is transforming our lives, this article gives a step-by-step approach on how enterprises can seamlessly connect their mobile workforce to back-end systems for increased productivity.
Reza Shafii explains how to satisfy two fundamental needs of API design and implementation, as defined by the API hierarchy of needs, with RAML, API Designer and APIkit.
We demonstrate how to build a RESTful API on top of CQRS systems. The result joins HTTP semantics and REST style with distributed computing concerns such as eventual consistency and concurrency. 4
The Android Developer’s Cookbook is a solid reference book for mobile app developers that can serve as an authoritative guide for sound programming practices. A nice addition to a dev's book shelf. 1
This article (the second in a four-part series) focuses on the design of a hypermedia server based on the API designed for the class scheduling problem domain outlined in part one of the series. 1
This article (the first in a four-part series) focuses on the design of a hypermedia type, by mapping a particular problem domain to hypermedia messages, as a basis for the API. 1
InfoQ spoke with Jaroslav Tulach about his latest book Practical API Design. We are also making an excerpt from the book available for our readers.