HTTP API Design

By Thomas Hunter II

Elevator Pitch

This talk takes a deep dive into the world of designing HTTP API’s. We’ll examine raw HTTP requests and responses, cover the various HTTP methods, the status code ranges and common status codes, and request and response headers. We’ll also look at data design and compare common API standards.

Description

This talk takes a deep dive into the world of designing HTTP API’s. We’ll examine raw HTTP requests and responses, cover the various HTTP methods, the status code ranges and common status codes every API should probably include, and different request and response headers as well as their meanings.

We’ll also look at data design, such as the actual body content and envelopes to convey metadata, and compare common API standards. Standards we’ll look at will include JSON API, GraphQL, MessagePack, JSON RPC.

Notes

Presentation: https://thomashunter.name/presentations/http-api-design-v1/

Here’s a list of other talks I’ve given: https://thomashunter.name/talks

This talk is based on content from my book Advanced Microservices: http://amzn.to/2sqp4qE