Table of contents adidas API Guidelines General Guidelines Introduction API First Contract Robustness Version Control System Minimal API Surface Rules for Extending JSON Security REST API Guidelines Introduction Core Principles OpenAPI Specification API Design Platform Design Maturity Testing Functionality Protocol HTTP TLS Separate Concerns Request Methods Status Codes Message Message Formats Content Negotiation HAL Problem Detail Foreign Key Relations Application Corporate Data Model Common Data Types Quality Execution Pagination Asynchronous Tasks Batch Operations Search Requests Query Requests with Large Inputs Choosing Fields and Embedded Resources Localization Rate Limiting Caching Evolution Naming Conventions Reserved Identifiers URI Structure Changes and Versioning Testing Enviroments Guides API Testing CI Environment Complete API Development API Clients Loose Coupling Further References Kafka Guidelines Introduction