API Design
17 November 2019
There’s more to publishing external APIs than choosing an API management vendor
Publishing a public API involves many considerations, from billing and metering through to documentation and on-boarding. These are likely to be addressed through a collection of solutions rather than a single all-singing, all-dancing API management platform.
25 April 2018
What makes a REST API mobile-friendly?
REST API design is dependent on the clients that will be consuming the resources - APIs that are designed for server-based integrations tend to look quite different from those that are designed to support mobile applications.
20 March 2018
GraphQL will not solve your API design problems
If you find REST APIs difficult to design, develop and scale, then your experience with GraphQL is not going to be any easier.
14 August 2017
Swagger is not WSDL for REST. It’s much less useful than that…
Swagger enables the same kind of automated discovery and integration that WSDL was invented to support. In doing so it undermines the design of REST APIs and doesn’t even provide adequate documentation.
4 June 2017
Can consumer-driven contracts manage breaking change in microservice integrations?
One of the more enduring problems with service integration is managing change in service interfaces. Consumer-driven contracts can help to detect breaking changes, but this visibility comes at a price.
16 May 2017
API management and the return of the enterprise service bus
No self-respecting integration platform is complete without an API management story these days. Is this just a RESTful return of the enterprise service bus?
12 July 2016
Simplifying .Net REST API development: Nancy, self-hosting and ASP.Net Core
REST API development using ASP.Net WebAPI is so fussy compared to other ecosystems such as Node.js and Ruby. New frameworks are emerging that promise to simplify both development and hosting of APIs in the .Net world.
23 March 2016
API gateways and the dangers of creeping middleware scope
An API gateway can solve many generic problems in an API infrastructure, but you do need to define a clear remit and protect against creeping scope.
12 December 2015
Pragmatic REST: APIs without hypermedia and HATEOAS
If you’re not using HATEAOS then you’re not using REST. That’s true enough, but in many cases adopting HATEOAS doesn’t deliver much value beyond architectural purity.
27 September 2015
REST APIs don’t need a versioning strategy - they need a change strategy
Change in an API is inevitable. Attempting to manage this change through version numbering usually creates more problems than it solves.
2 July 2015
Comparing Gartner’s cloud integration leaders: Informatica, Dell Boomi and Mulesoft
Gartner’s definition of enterprise integration as a service is so wide that it can be difficult to draw any meaningful comparisons between the platforms in the “leaders” space.
22 November 2014
The RESTafarian flame wars – common disagreements over REST API design
Debates on the finer points of REST can bring out the worst in people as they seek to define what is and is not “RESTful”. In most cases the debate is unlikely to make the difference between success and failure for an API.
15 October 2014
Parsing OData queries for decoupled data entities in ASP.NET WebApi
If you adopt OData you don’t have to expose the entire range of query functionality for every resource. You can use the OData libraries to parse queries and interrogate data directly.
22 July 2014
Using a tolerant reader for web service integrations in .Net
Using version tolerant readers can help you to cope with changes to service contracts though this does come at the expense of a weaker contract. The approach is more appropriate for fluid services that are prone to frequent change.
21 April 2014
Hackable URIs may look nice, but they don’t have much to do with REST and HATEOAS
Structured and Hackable URIs are a staple part of SEO-friendly websites. Although developers generically expect to see them in HTTP-based APIs, they should be irrelevant to consumers of a fully RESTful API that leverages HATEOAS.