How to turn a 403 into a 202 at the API Party - Gwen Diagram & Ash Winter image

How to turn a 403 into a 202 at the API Party - Gwen Diagram & Ash Winter

  • Locked
Ash Winter's profile
Ash Winter


Gwen Diagram's profile
Gwen Diagram

Head of Engineering

Talk Description

The Challenge

API design looks easy right? Lots of material, methods and examples to look at. However, we've not been on a team that hasn't struggled to build a clean interface for their consumers. From unconventional use of status codes, difficult to parse responses to endless debates about what to name endpoints. This is coupled with iteratively built API's, which potentially realise value and feedback earlier but may suffer from inconsistency over time.

What we'll talk about
We believe that testing can help to overcome some of these challenges through some common patterns, that we've identified through experience:

  • 3 Amigos - being part of the conversation early and often, with the right people, based on not just the implementation but the wider impact on adjacent systems.
  • Test First - creating the right level of tests before implementation together can expose inconsistencies in data and structure. Documentation up front means that the API is usable by other teams before it is even written.
  • Exposing Complexity - designing the tests first can help expose issues with chaining multiple requests which may be a symptom of an overly complex architecture.
  • Scalability - identifying areas that need to be extremely scalable and those that don't by levering domain knowledge.

How it will help

By testing first, common errors with API design can be flushed out quicker, even before the code has been written. Design and architecture should not be left to the developers and architects, by following some of these guidelines, as a Tester you will be able to contribute to a consistent, transparent and maintainable API.

Join the discussion about TestBash Brighton over at The Club

What you’ll learn

By the end of this talk, you'll be able to:

  • Describe what a REST API is
  • Outline the component parts of an HTTP request and response
  • Outline approaches to get involved in testing API designs
  • Describe approaches to testing API designs
  • Outline approaches to documenting API designs
Ash Winter's profile'

Ash Winter


About Speaker

Ash Winter is a consulting tester and conference speaker, working as an independent consultant providing testing, performance engineering, and automation of both build and test. He has been a team member delivering mobile apps and web services for start ups and a leader of teams and change for testing consultancies and their clients. He spends most of his time helping teams think about testing problems, asking questions and coaching when invited.

Gwen Diagram's profile'

Gwen Diagram

Head of Engineering

About Speaker

<p>Gwen Diagram is a technology professional from Leeds who specialises in testing.  She is an avid automation evangelist with a focus on testing complemented by repeatable build processes with monitoring. She has had varied roles throughout her career including Scrum Master at a Start Up, Engineering Manager at a bank and DevOps kid at a large Financial Services organisation. She is currently the Head of Engineering at Glean in Leeds.</p> <p>As a strong believer in making the tech industry as open and punk as possible, she co-organises a twice yearly free day long testing conference called the Leeds Testing Atelier.  She speaks regularly at local meet-up groups, Agile Yorkshire and Leeds DevOps, duels with creative types at events like the Tech Off, speaks internationally at conferences such as Nordic Testing Days in Tallinn and was the closing keynote at Agile on the Beach in Falmouth, UK in 2018.</p> <p>Outside of work, you will usually find her hanging around a Natural History Museum somewhere in the world marvelling at how incredibly excellent dinosaurs are, feeding pigeons or ducks or obsessing over transport.</p>

More Talks
Testing Progressive Web Apps (or How to Achieve App-iness) - Elizabeth Fiennes and Callum Akehurst-Ryan

0h 29m 34s

Stories from Testing Voice First Devices, Such as Alexa - Kim Knup

0h 30m 53s

How to Test Serverless Cloud Applications - Glenn Buckholz

0h 45m 52s

The Automated Acceptance Testing Paradox - Mark Winteringham

0h 28m 8s

Lessons Learnt Moving to Microservices - Simon Dobson

0h 27m 16s

99 Second Talks - TestBash San Francisco 2018

0h 40m 22s

A Pairing Experiment – Katrina Clokie

0h 30m 43s

Next Stop: FlixBus! A Tester Exploring Developer Land - Lisi Hocke

0h 31m 31s

United by Security : The Test that Divides Us - Jahmel Harris & Claire Reckless

0h 35m 37s

Test Leadership In Requirements & Specification Stages

0h 28m 27s

Testing Against Implicit Requirements

0h 25m 14s

Crossing Over: How Developing a Feature Made Me Love Testing Even More - Amber Race

0h 26m 19s

The Forgotten 'Ility' - Ash Winter

0h 30m 11s

Part Of The Pipeline - Ash Winter

0h 32m 10s

How To Win With Automation And Influence People - Gwen Diagram

0h 31m 23s

99 Second Talks - TestBash UK 2022 Day 2

0h 54m 42s

Is Test Causing Your Live Problems? – Gwen Diagram

0h 20m 38s