Documentation-driven development for Python web APIs

Tools and frameworks for successful API integrations

Jose Haro Peralta

APIs Deployment/Continuous Integration and Delivery RESTful Testing Web Servers and MicroFWs (Flask/Tornado/Nginx/...)

See in schedule: Wed, Jul 28, 15:45-16:15 CEST (30 min) Download/View Slides

This presentation shows how we can use documentation-driven development to minimise the risk of API integration failures. APIs are the gateways that connect our web applications to the world. Microservices rely on them to work together, and frontend applications use them to connect to our backend. Despite their importance, API integration failures are a daily occurrence. There’re many reasons for this, but a common factor is the lack of API documentation, or the use of bad API documentation.
Often, API documentation comes in unstructured formats or in JSON examples, instead of standard formats such as OpenAPI or Schema Definition Language. When we don’t use standards to document our APIs, we give up the whole ecosystem of frameworks and tools built around those standards. Such tools and frameworks are designed to make our lives easier when managing the lifecycle of our APIs.
In documentation-driven development, we write the API specification first, and then we implement the API server and the client against the specification. I’ll show how we can use mock servers to test the client while the backend is being developed, and tools like Dredd and schemathesis to validate the backend implementation. I’ll show how we can use these tools in a CI server to validate our code before it’s released. This approach doesn’t eliminate completely the risk of API integration failures, but it helps to minimise it.

Type: Talk (30 mins); Python level: Intermediate; Domain level: Intermediate