Posts Tagged: dx

How to Smartly Sunset and Deprecate APIs

The life of an API follows a predictable lifecycle – from creation to deprecation, each stage of the API lifecycle denotes an important event, and it carries with it a set of best practices. API developers tend to think about the future in very positive ways – how the API will behave, what its design will be – but in doing so, they don’t always consider what the end of that API might look like. Read more

Do API Standards Differ From Industry to Industry?

At first glance, it would seem that the API space has embraced unified design standards. RESTful development uses HTTP to communicate between a client and a server. OpenAPI Spec serves to extend REST APIs, improving documentation and making APIs machine-friendly.

However, with just a little digging, it becomes apparent that this isn’t always the case. Read more

How Workarounds Reveal the True Needs of Your API Consumers

Workarounds are clever, but less than ideal solutions to problems that shouldn’t really exist. In the world of APIs, an example of this might be scraping an application’s frontend to make up for endpoints that don’t exist.

At first sight, workarounds may seem like a bad thing. Read more

DX Should Be a Priority, Reveals State of API Report 2019

As we make the shift towards treating APIs more like bonafide products, Developer Experience (DX) is only becoming a more prominent topic. Over the last few years, you’ve probably noticed a growing amount of literature, tooling, and discussion on the subject of DX. Read more

5 Examples of Excellent API Documentation (and Why We Think So)

If you’ve been spending much time on the Nordic APIs blog, you’ll know that developer experience is something we’re passionate about. Creating a smooth and enjoyable experience for those implementing your APIs is essential with just how much competition there is nowadays, and API documentation is one of the keys to success. Read more