Consistent naming conventions in APIs significantly improve developer experience and AI agent consumability. Four well-designed APIs demonstrate effective practices: Amadeus Hotel List API uses kebab-case for resources with clear versioning; OpenWeatherMap API employs intuitive, jargon-free naming with hierarchical URI structure; Spotify Web API follows clear patterns with plural nouns for collections and singleton resources; and Stripe API maintains consistency across its massive resource catalog. Key principles include using predictable case conventions (kebab-case for URIs, camelCase for parameters), including version numbers, avoiding special characters, using plural nouns for collections, and maintaining hierarchical structure with forward slashes.
Table of contents
Amadeus Hotel List APIOpenWeatherMap APISpotify Web APIStripe APIImprove the Developer Experience with Great Naming ConventionsSort: