Blog

Contrasting API Contract Testing and Functional Testing

I am neck deep in very philosophical debates around API specifications and testing right now, which I am working with my team get more precise in how we discuss API testing and avoid drowning in the semantics and perspectives that spin many of these conversations out. As always, I need to work through independently aspects of this conversation using storytelling, so that I can wrap my brain around the nuances and details of it all.

Live By APIs Die By APIs

One of the things I love and hate about the API universe is that if you live by APIs, you will often times die by APIs, unless you can perpetually dial in just the right balance across how much value you generate, keep for yourself, or make accessible to others. I’ve fictionally written about how APIs are just the Sentinels from the Matrix, in that they first began as construction bots helping humanity, and then once the Matrix took control of humanity, their roles changed. Of course, this...

We Are Just Swiping Credit Cards, Doing Our Accounting Using Multiple Sets of Books, and Do Not Allow Time for Budget Planning in the API Space

I heard a phrase this past week that when it comes to APIs—that we are all just swiping the credit card and then working to do accounting after the fact. So much truth. I would augment that state with the reality that we aren’t ever spending anytime budget planning. It is implied, but I think it is important to bring it front and center and balance out our belief we can accomplish everything we need with accounting after the fact. While I am no planner when it comes to my own APIs or my fi...
Kin Lane

The Most Important API Layers To Focus on in the Enterprise

As folks turn their attention to artificial intelligence, productivity, and other distractions emerging across our technology dominated worlds, I am taking a moment to assess the areas that I feel confident are the most important API layers to be focusing on when it comes to the enterprise. Depending on your role within the enterprise, at a startup, within venture capital, or other performer in this Broadway musical we call the tech sector, you will see things differently. Even though I wo...
Kin Lane

Y’all See API Contract Testing Like You Do Terms of Service

I keep working through my API contract testing discussions with folks. I wrote about getting pedantic when it comes to API contract testing last night to help me get a grasp on things, and I am working on a piece about change to augment this post, but as I was laying there last night thinking about all of this, I am realizing that folks see API contracts in the same way they see terms of service...
Kin Lane

Getting Pedantic About API Contract Testing

I am immersed in very detailed and pedantic discussions lately about API contract testing lately. Like many phrases in the world of APIs, the phrase contract testing gets thrown around a lot, without much understanding of what it means. I use it so often, and hear it so often, in so many different scenarios I lose track of what it means. Thankfully Kevin Swiber (@kevinswiber) is on my team and regularly gets all pedantic about it on calls, with...
Kin Lane

Learning About Railroad Regulation in the Empire Express

I just finished reading the Empire Express by David Haward Bain. It took me a couple months as I read on the side and contrasted with other more nourishing reads from widely different universes. However, after finally finishing the 700+ pages I am left with many stories and tales to use in my regular work as the API Evangelist. I picked up the book to learn more about the regulation that went into not just this monumental “road Bbuilding”, but also laying of the telegraph lines across this...
Kin Lane

How I Use Postman for Algorotoscope — API-First, No UI Needed

One of the things I really like about Postman as a platform is that I really can go cheap on the user interface. I have several APIs in which I do not have any UI. I only need the data managed via API, and anytime I do need some sort of output for my storytelling, I use Postman visualizer to get what I need. One example of this in action is my Read more →
Kin Lane

The Source of Truth for an API

I was talking with Laurent Broudoux (@lbroudoux) and Yacine Kheddache (@YadaYac) over at Microcks this week. As I listened to them discuss the intersection of multiple API protocols like HTTP, gRPC, and Websockets, multiple specifications like OpenAPI, AsyncAPI, and Postman Collections, as well as multiple stops along the API Lifecycle like documentation, testing, and mo...
Pascal Heus

Using ChatGTP to convert human knowledge into machine actionable formats

Human knowledge has naturally for centuries been captured in human friendly formats such as books, intended to be consumed by, you guessed it, humans. But our world has changed dramatically and we now live in a space where this needs to be shared with computers. Machine driven processing, learning, or intelligence requires access to human knowledge in digital formats. We have more or less completed the transition from paper into formats such a PDF, Word, Excel, HTML, but these are unstru...
Kin Lane

Twitter Should Be Able Charge for Their API Because It Costs Money to Operate

I’ve heard this phrase seven times now from people on Twitter and LinkedIn-—that Elon Musk is just making a business decision to charge money for the Twitter API because it costs Twitter money. In the moment, with your narrow capitalist blinders on, this is a very logical argument. As someone who has been arguing that Twitter should be charging for their API for over a decade, this argument isn’t as sophisticated and logical those wielding it might think. I know this isn’t what you want to...
Kin Lane

Twitter Is the Most Important API

I am pissed about Twitter shutting down free access to their API. It genuinely breaks my heart. I’ve seen many people who do not quite grok how I feel, so as I do with any topic, I am looking to do some storytelling around the subject. After diving in for a day, I can tell this isn’t going to be something I can make sense of in a single post, and predict there will be several essays required, and honestly, I am feeling like I want to get into book mode on this subject. Seriously, I am not ...
Kin Lane

A Loose Federation of API Standards

I am corresponding back and forth with what I will call an open source and API standards therapist for now, helping me make sense of the ocean of API standards I am drowning in and assisting me in finding a way forward with. In my personal style, I need to write my way forward, processing what they have been sharing, and try to find ways I can take meaningful steps forward.At the scale and scope in which I operate in, it is a daily challenge for me to not be overwhelmed by what is happenin...
Kin Lane

My Mastodon #FollowFriday Postman Collection

I have been making a number of Postman collections to help automate and scale my new Mastodon universe, and when I share them I get one of two responses: 1) these are awesome and I’ll be putting them to use, and 2) these appear to be awesome but I have no idea what they are and how they work. Once again helping me realize that you are either in the know about APIs (and Postman), or you aren’t. Those of us in t...
Kin Lane

One Possible Vision for API Commons

Everything in this world seems to occur in cycles, with many patterns I’ve wrestled with years ago coming around again. In 2014, in the heart of the Oracle vs. Google, me and my partner in crime Steve Willmott created the API Commons and APIs.json to help us make sense of the sprawling API landscape we saw emerging. I’ll dive into what each of these projects were shortly, but in short, they are machine-readable open so...
Kin Lane

What Comes After Microservices?

Good API trends can linger on for some time, but as with the decline of monolith, many love to anticipate the death of microservices through strangulation by its own distributed weight. While event-driven, circuit-breakers, GraphQL, and other leading patterns will continue to help us orchestrate successfully across this chaos, there are some other elements of our API operations that will be shaping what the API landscape looks like in the coming years.
Kin Lane

Remembering How I Built API Evangelist As I Rebuild My Social Presence

As I work to rebuild my social presence via Mastodon, I am reminded of how I built API Evangelist using Twitter and my blogs between 2010 and 2020. I am very invested in API platforms these days, and API blah blah blah that will attract the attention of enterprise organizations. So I tend to tell stories about things like API collaboration, automation, and governance, and things that API producers care about. As I do the work each week to slowly build my Mastodon community for my API Evang...
Pascal Heus

Can you read or write? A metadata story.

This is a short story about metadata (I have to assume at this point you can read). About why a data file or dataset on its own is inadequate for analysis or research, and therefore insufficient to draw conclusive evidence or make informed decisions. Why you should never publish data or make it available through an API without its documentation. And, being mindful that computer applications are the immediate data consumers, emphasize the importance of machine actionable metadata. Here is a...
Pascal Heus

Will I become a Rustacean?

I was recently reading this article about “Why Python is not the programming language of the future”. I’m not sure whether this will happen, but the author makes some very interesting points. One that I’m particularly sensitive about is performance. I grew up as a C/C++ developer (and other languages like Pascal, Assembly, COBOL, Prolog, LISP, or even APL). These we...
Kin Lane

How to Draw an Owl, the API Edition - Part One

I am down in the quantum realm when it comes to API operations. Working at the atomic level when it comes to how we do APIs. One of my favorite ways to make fun of APIs is to use the How to Draw an Owl analogy for how we teach people to do APIs. TL;DR we leave out a lot of details when we talk about and teach people about APIs. To help me address this problem in my storytelling I am exploring how we can use common approaches to API governance to enable teams across the enterprise to do the...

Mastodon #HashTags as an API Search Engine

I am fascinated with cultivating the hashtags that come through my Mastodon instances. I have two domains setup. Kin Lane and API Evangelist. My personal one is more photos, libraries, travel, outdoors, where my professional one is APIs, data, platforms, and protocols. Once you start following, following, posting, and engaging with other instances, your hashtag trends begin to evol...

Postman Interceptor But for Product Managers

I was talking to someone yesterday about the growing need to reverse engineer what is happening across this sprawling API landscape. While there is a lot of focus on having an API strategy, standardizing the API lifecycle, and investing in API governance, the greatest benefit Postman providers for developers is the ability to reverse engineer and make sense of the API chaos around us. You can turn on Read more →
Pascal Heus

Need synthetic data? Mockaroo to the rescue

Data intelligence and Metadata Inference I recently spent some time exploring one of my favorite data intelligence related topics: metadata inference. How do we take an undocumented dataset, like a CSV file, and automatically generate documentation and knowledge around it with no or minimal human intervention. The end goal being to uplift data and complement with machine actionable metadata and transform it into digital knowl...

Make Legacy APIs Visible To Highlight Technical Debt

If you tune into my storytelling, you’ll hear me say this a lot—-APIs are hard to see. Any API, but more importantly, legacy APIs are just really hard to see. As a result, it is very difficult to quantify the technical debt that is accumulating across the enterprise. None of the enterprises I talk to know where all of their APIs are, and the older the API is, the higher the chance the API doesn’t have up-to–date documentation, artifacts, and other things that help us see the surface area o...

Make Incidents Visible and Informing the Shift Left

I am always looking for ways to help teams fight the good fight when it comes to cultural change across API operations. The technology of APIs takes a lot of work, but it never requires as much work as the business and people side of API operations. Gathering stories from across the conversation I am having, sharing them here on the blog, and via the Postman blog is how I look to scale my advice and guidance for shifting enterprise behavior. Today I wanted to aggregate a handful of stories...