Posts Tagged: best practices

eBook Released: GraphQL or Bust

We are very happy to announce a new eBook release! Download GraphQL or Bust today for FREE!

GraphQL or Bust

Discover the benefits of GraphQL and gauge if it’s a good move for your web API: 

Download direct for FREE in PDF, MOBI, or EPUB

Also available for purchase on Leanpub and the Amazon Kindle store (soon!). Read more

How to make self-descriptive APIs

How To Make A Self-Descriptive Enterprise API

One of the hardest things to do as an API provider is to work within the enterprise environment. This is due, in large part, to the very nature of enterprise structures – often slow to adopt new technologies, fundamentally distrustful of external solutions, and far more insular than most modern corporations would like to admit. Read more

Introduction to API Versioning Best Practices

Change is inevitable and growth is a good thing. When your API has reached the point of expanding beyond it’s original intent and capacity, it’s time to consider the next version.

Whether that next iteration is a whole number version bump or just a feature expansion, it’s important to consider the pros and cons of how you let your developers know about it. Read more

An Introduction To API Economy Boosting Principles

People develop APIs for all sorts of reasons. They might be trying to create a tool to facilitate internal processes where they work, they could be building an external product for customers, or they might be building a third party tool designed to mash-up other services. Read more

Best Practices for API Error Handling

Best Practices for API Error Handling

Error codes are almost the last thing that you want to see in an API response. Generally speaking, it means one of two things — something was so wrong in your request or your handling that the API simply couldn’t parse the passed data, or the API itself has so many problems that even the most well-formed request is going to fail. Read more