Copy
The week in API strategy, news, articles, and upcoming events.
James Higginbotham, Curator  A hand-curated weekly newsletter for API developers, sponsored by LaunchAny and CaseySoftware

Find this via Twitter? Subscribe now so you don't miss out
 
 

API Developer Weekly

Sept 29, 2022 - Issue #425
This week, we have a look at how to fix what you screwed up in your API, from design to security. We also look at setting SLAs for your API, some videos from the recent ASC Conference, some recent tooling releases, and how to document AWS SQS event-driven APIs using AsyncAPI. We also have a look at how APIs can transform a business into a platform provider. 

Happy Reading!
-- James
 
Hot Topics
API First and API First Aid
The web is filled to the brim with information about API First approach to API development, and why it is good for you, your products, your cat, and for many other things. I will spare you the evangelism (ok, I'll allow myself just a little bit...) by Udi Shemer [medium.com]

How to Set SLAs for Cloud APIs
Cloud APIs have been all the rage for the past several years. Serverless architecture has been on the rise, for one thing, which has become increasingly common in the world of remote work and collaboration. Some are predicting that cloud API adoption is going to expand by 600% by 2031. by J Simpson [nordicapis.com]

Hyrum's Law: Hyrum Wright on Programming over Time
Hyrum's law is important for anybody building software that is using or is used by other software (which of course means: for everybody building software). The law is as following: With a sufficient number of users of an API, it does not matter what you promise in the contract: all observable behaviors of your system will be depended on by somebody. by Erik Wilde [youtube.com]

Wielding the Double-Edged Sword of JSON Schema - David Biesack, Apiture
JSON Schema plays a crucial role of defining message payloads in the OpenAPI and AsyncAPI specifications. The JSON Schema specification is a very mature and robust standard for describing how to validate a JSON payload. It is a sharp sword, precise and well-honed to that job. by OpenAPI Initiative [youtube.com]

Results of the State of DevRel Report
Come and find out the results of the 9th State of Developer Relations Report.
We'll also have a panel share their thoughts on the Report's highlights and what they mean for Developer Relations. Tune in live or catch the reply. [stateofdeveloperrelations.com]

GitHub - alufers/mitmproxy2swagger: Automagically reverse-engineer REST APIs via capturing traffic
A tool for automatically converting mitmproxy captures to OpenAPI 3.0 specifications. This means that you can automatically reverse-engineer REST APIs by just running the apps and capturing the traffic. 🆕 NEW! Added support for processing HAR exported from the browser DevTools. See Usage - HAR for more details. by alufers [github.com]

Release v1.0.0-next.8 · asyncapi/modelina
You can't perform that action at this time. You signed in with another tab or window. You signed out in another tab or window. Reload to refresh your session. Reload to refresh your session. by asyncapi [github.com]

Documenting SQS event-driven APIs with AsyncAPI
Hey, do you remember what this field looks like in GET /operations? Ever since I started working in a team, the answer to that first question has been pretty straightforward: Sure, let's check the OpenAPI documentation file. After two or three times, people who didn't work with our codebase started remembering where the information was and stopped asking altogether. [asyncapi.com]

5 Examples of API Documentation With Great Developer Experience
Proper API documentation is essential. It helps you onboard developers faster, increase the number of integrations, reduce support requests, and enhance customer satisfaction. On the other hand, improper API documentation can frustrate your customers and even lead to lost opportunities. Below, we'll look at five new examples of excellent API documentation and explain the unique features that made them great. by Vyom Srivastava [nordicapis.com]

HTTP Message Signatures
This document describes a mechanism for creating, encoding, and verifying digital signatures or message authentication codes over components of an HTTP message. This mechanism supports use cases where the full HTTP message may not be known to the signer, and where the message may be transformed (e.g., by intermediaries) before reaching the verifier. [datatracker.ietf.org]

 
Business of APIs
How APIs Can Transform Businesses Into Platform Providers
In a 2021 study by digital economists at Chapman and Boston universities, it was found that businesses that recognize the benefits of Application Programming Interfaces (APIs) and adopt the technology may grow 38% faster than those that do not. With [...] [startupbeat.com]

Sometimes Boring is OK
For inquiries about sponsoring the podcast, please send us an email. Include details about the company requesting the sponsorship. The Cloudcast is the industry's leading, independent Cloud Computing podcast. Since 2011, co-hosts Aaron Delp & Brian Gracely have interviewed technology and business leaders that are shaping the future of computing. by Brian Gracely [thecloudcast.net]

The APIs You Really Don't Know About
By: Don Macvittie on A few years ago, we were rightly warned about the amount of exposure our APIs created. A massive attack surface that often used "security by obscurity" as its primary method of protection. We've come a long way since then, building secrets, tokens, RBAC and even more into our API interfaces. by Don Macvittie, Stephen McKenna, Mattias Andersson, Arunava Bag, Mike Vizard, Venkata Achanti, Richi Jennings, Mitch Ashley, Alan Shimel, Bob Davis [devops.com]

(Un)Related
How to Build a Modern Data Infrastructure Using a Lakehouse
There is growing interest in building modern data architectures on lakehouses. Here is what you need to know to make it happen - from the folks at Persistent Systems. by Purushottam Darshankar [thenewstack.io]
 
 
Want to share something?
As always, if you want to chat, share a link, or make a suggestion, feel free to drop us a quick note or tagging us on Twitter (@launchany and @caseysoftware) or by emailing us at: james@launchany.com
 
UPCOMING EVENTS
Follow on Twitter    Forward to Friend    Subscribe
Copyright © 2022 LaunchAny, All rights reserved.
unsubscribe from this list