Meaningful Collaboration Across The API Lifecycle
- Kin Lane tl;dr: Collaboration is at the heart of successful software development, but working together on APIs brings challenges. In this article, Kin Lane, Chief Evangelist at Postman dives into the critical components of meaningful API collaboration across the API lifecycle and provides insights and strategies for success.featured in #411
featured in #375
Structured Error Messages For HTTP APIs
- Nicolas Frankel tl;dr: Nicolas identifies 2 problems: (1) HTTP status codes were specified for human-to-machine interactions via browsers, not for machine-to-machine interactions via APIs. Hence, selecting a status code that maps one-to-one to the use case is rarely straightforward. (2) The error payload's structure is unimportant if a single organization manages the client and the API provider. However, the issue occurs when a team decides to use a third-party API.featured in #364
OpenAPI Tutorial: How to Automatically Generate Tests for OpenAPI Generator SDKs
- Lee Wang tl;dr: OpenAPI is an industry-standard definition language for building patterned, uniform APIs. This OpenAPI Tutorial includes code samples, templates, and testing strategies for generating SDK code for APIs you're building.featured in #349
featured in #349
Under The Hood: How We Built API Versioning For LinkedIn Marketing APIs
- Nihit Purwar tl;dr: "We were releasing breaking changes almost monthly with different sunset dates – making it hard for developers to test and plan their roadmap without a predictable release schedule. Unversioned APIs also blocked customers from accessing the latest features and caused internal challenges with new feature development." Nihit's discusses how his team set out to build API versioning for LinkedIn Marketing APIs.featured in #346
Best Practices For Making API Calls At Scale
- David Donnelly tl;dr: 3’s a crowd and 429’s a rate limit exceeded error. We explore best practices for making API calls at scale, the 4 most common ways rate limits are implemented, and a methodology for avoiding rate limits dynamically.featured in #331
featured in #295
How To Design A Good API And Why It Matters
- Preslav Mihaylov tl;dr: Based on a 2007 talk, this post covers why APIs matter, the process of design, general principles, and briefly bullets out class, method and exception designs.featured in #266
Podcast 313: What Makes For A Great API?
- Ben Popper tl;dr: "This week with chat with Matt Biilmann, CEO of Netlify, who has been building developer tools, content management systems, and web infrastructure for more than 30 years and is recognized for coining the term “Jamstack.” He opens up about what, in his opinion, makes a great API."featured in #225