Releases: garyfleming/apis-for-decades
Codemash, Sandusky, Ohio, 11/01/19
Minor tweaks from last version, mostly around Consumer Driven Contracts
Oredev, Malmo, 20/11/18
A fairly big structural change with a lot of things, like The Form of Things, moving earlier. Some things cut, some added.
DotNetSheff, 07/08/2018
A version I gave at DotNetSheff, in Sheffield. Most of the changes from the last published version are around the generic controls sections. There are other minor tweaks too.
Python Glasgow, 10/04/18
Slightly updated version given at Python Glasgow, 10/04/18.
The main changes were more at the end around forms and the idea of form, a little bit about JSON being an improvement over XML (which was itself better than the previous mechanisms), and a slightly reworked ending. It also features an extra cat picture.
DDD Scotland, 10/02/2018
The first longer outing of this talk, at DDD Scotland on 10/02/2018. It runs around 40 minutes.
Questions afterwards were (from memory):
Q: How do you write a client that handles this?
A: For things that are generic (next/prev links etc) that's easy enough, but for most stuff you need to shift from thinking about fixed integration (using pre-defined URLs) to domain knowledge. Your API has to say explicitly what the resources and actions are, and clients need to work in those terms.
Q: Where exactly are you suggesting we use HTML5?
A: As the serialization formats for APIs we serve up. Where we use JSON today, I'm suggesting we use HTML5 because it has everything that JSON has and a bunch of stuff I think is useful.
Q: Isn't something like Swagger good enough?
A: Swagger is a useful thing by itself, but it still encourages fixed integration, rather than learning the controls available at any given moment. That encourages clients to couple themselves to how things are today, rather than being open to change.
Lean Agile Glasgow 08/11/17
This is the version of the talk I gave at Lean Agile Glasgow on 08/11/17. It's still fairly short at this point: 20ish minutes.