Archive by Author

What Skills Do Your APIs Offer?

Much has been written about API design techniques – from choosing the right HTTP verb to guidance on response code usage and hypermedia dos and don’ts. We get caught up in the technical details of what our API should look like under the covers, while ignoring the humans that the APIs were designed to help. […]

Comments Off on What Skills Do Your APIs Offer?

Slack, Chatbots, and Voice: At the Intersection of Humans and APIs

Over the last year, we have seen growth in messaging platforms for business. These platforms have changed the way we communicate within and across teams. But why have these platforms succeeded where others have failed to gain the same kind of traction? This article explores the growth of messaging platforms, how APIs and chatbots are changing the way […]

Comments Off on Slack, Chatbots, and Voice: At the Intersection of Humans and APIs

Avoiding Monolithic Regret

The last year has seen a considerable spike in the number of articles and discussions around microservices. Many think that a microservice-based architecture is the right answer for their organization, whether they are a startup or a large-scale enterprise. Others are opting for a wait-and-see approach to microservices by first adopting a monolithic architecture. A […]

Comments Off on Avoiding Monolithic Regret

Resolving the Frontend/Backend API Design Conflict

As part of my API design consulting engagements, I’m often called in to resolve the conflict between the API design that the frontend developers would prefer to have and the backend developers want to build. These conflicts can often be a serious distraction and over time can build into bigger issues within the team. So, […]

Comments ( 2 )

Lessons From Training 1400+ People in Web API Design

For the last 2 years, Keith Casey and I have been conducted API training workshops with over 1400 participants across nearly a dozen roles. While we are still available for training engagements, we wanted to stop and take an assessment of what we have learned so far. We hope that by sharing these lessons, we will help your […]

Comments Off on Lessons From Training 1400+ People in Web API Design
Asking for help with your startup

Building Your API Documentation Strategy For SUCCESS

So far, we have put together a foundation for our API documentation: 1. We must first move beyond API reference documentation and look for other ways to communicate the value and purpose of your APIs 2. APIs are conversations between client and server. Extending these conversations is important and documentation can help surface opportunities and gaps […]

Comments Off on Building Your API Documentation Strategy For SUCCESS
Common Questions for API Documentation

10 Questions Your API Documentation Must Answer

Effective communication is the most important factor for API success. APIs do not have a user interface, so your documentation is the primary communication method for developers to interact with your API. As my API training partner Keith Casey states, “Documentation is the third user interface for APIs, and the most important”. Your API Documentation […]

Comments Off on 10 Questions Your API Documentation Must Answer

Improving Your API Conversations with Hypermedia, ETags, and Real-Time APIs

There is considerable source material on great API design. We can read discussions on how to use HTTP properly, from selecting the proper HTTP verb to which response code(s) are appropriate to return based on the success or failure of the request. These are all important things to consider when designing a great API. As API providers […]

Comments Off on Improving Your API Conversations with Hypermedia, ETags, and Real-Time APIs

Moving Beyond API Reference Documentation

“Great API documentation is essential” many people exclaim. So, you fire up your favorite API definition editor and start writing docs. You learn what YAML is and how to format it properly. You agonize over the URL paths, verbs, response codes, and payload definitions. Finally, you reach that glorious moment: “Documentation is done! Whew!” Not quite. […]

Comments ( 1 )

How To Successfully Deploy Your Web or Mobile API to Heroku

I have deployed a wide variety of APIs, from internal to APIs for public or partner consumption. Many of them have been deployed to Heroku. There are a variety of advantages, including reduced server configuration, easy scaling, and a great vendor ecosystem for third-party add-ons. However, many have not experienced Heroku before or have not […]

Comments ( 2 )