Tag Archives: api

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

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 )
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 Build a Great API Marketing Plan

I was recently approached by an API vendor at an API conference. While the encounter wasn’t horrific, I did find a few things related to their API marketing and sales process that left me less-than-excited to promote their product to my clients and other developers. To prevent you from making the same mistakes, I have captured some tactics […]

Comments Off on How to Build a Great API Marketing Plan

How Cloud APIs Transformed The Way We Build Software and Data Centers

I was recently asked why more companies are not taking more advantage of Cloud APIs from their cloud service providers to power their software product and IT initiatives. These companies, instead, are simply using the web-based dashboard consoles to provision and manage their infrastructure. The result is that they are using the same techniques they […]

Comments Off on How Cloud APIs Transformed The Way We Build Software and Data Centers

5 Tips For Wrapping Your Database With a REST API

Just about every mobile and web application is backed by at least one database. These applications often require a web-based API to expose the database(s) for storing, querying, and retrieving necessary application data. How can we build an API that exposes our application data but also ensure API longevity to support future needs? The Challenge of Mapping Tables […]

Comments ( 2 )

The Accidental API

How your web or mobile API might be putting your business at risk Do you have a web or mobile API? You might, whether you realize it or not. Web APIs are often used to connect a modern web application to the backend database using JavaScript frameworks such as Backbone, Angular, or Ember. Web APIs are also used by […]

Comments Off on The Accidental API