Creating Solid APIs

Explore the intricacies of creating robust APIs in this 44-minute conference talk from EuroPython 2018. Delve into essential topics such as versioning, authentication, response structure, and documentation. Learn how to implement best practices for each aspect, making your APIs more developer-friendly and easier to consume. Discover the importance of auto-generating documentation from code and understand the benefits of using standardized formats like JSON API. Examine OAuth2 authentication, its applications, and potential challenges. Gain insights on implementing versioning strategies to evolve your API without breaking existing applications. Conclude with real-world examples of major APIs employing these principles, equipping you with practical knowledge to create solid, user-friendly APIs for your projects.

Introduction
Background
API Definition
Documentation
Sales Pages
API Documentation
Endpoints
Generating Documentation
Generating Schema
Standardization
Chasing API
JSON API
JSON API Configuration
Special Cases
Authentication
Versioning
Version Transformers
Clients Perspective
Getting Started
Code Examples
Documentation Matters
Questions