What Does Hyrum's Law Mean for API Design?
When it comes to software behavior, developers often rely on what they get, and not necessarily what they're promised. The more developers you have, the more likely it is that somebody depends on your API's implicit behavior - an observation known as Hyrum's Law. [nordicapis.com]
API Design Guidance: Bulk and Batch Import
Some APIs require importing lots of data at once to prevent submitting 100s to 1000s of individual POST operations (a slow and tedious process as a result of a CRUD-based API design). There are two common use cases for bulk/batch processing: importing many resources via a single transaction or performing a background import of a large data set in an efficient manner. by James Higginbotham [tyk.io]
OAS vs. RAML: What's the Difference?
OAS and RAML are two popular API description formats. Although they were designed for slightly different purposes, many API owners only come to use one or the other, begging the question: which of the two should you choose? In this article, we offer a concise comparison of OpenAPI Specification (OAS) and RESTful API Modeling Language (RAML). [nordicapis.com]
Practical Hypermedia Controls
A lot has been written about REST but less so when it comes to Hypermedia Controls. I haven't seen too many Hypermedia based APIs out in the wild. I theorize that there are two main reasons for this. First, it is something many people haven't been exposed to, and second, it... [daniellittle.dev]
What goes into an award winning developer portal?
Interview with the 3 Jury Members who judged 32 developer portal nominations over 9 award categories for this year's Devportal Awards. The 10th award was awarded to the most popular devportal as determined by community votes. [pronovix.com]
How Netflix Scales its API with GraphQL Federation (Part 2)
In our previous post and QConPlus talk, we discussed GraphQL Federation as a solution for distributing our GraphQL schema and implementation. In this post, we shift our attention to what is needed to run a federated GraphQL platform successfully - from our journey implementing it to lessons learned. by Netflix Technology Blog [netflixtechblog.com]
An Introduction to WebSockets with Ballerina
WSO2 sponsored this post. WebSocket is a communication protocol used for efficient full-duplex communication between web browsers and servers over TCP. In this article, we will take a look at the history of the technologies used in dynamic websites. Then, we will introduce WebSockets as the modern approach in fulfilling these requirements while fixing the... by Anjana Fernando, Jimmy Song, Nočnica Fee [thenewstack.io]
GraphQL: One Data Model To Rule Them All? | Nordic APIs |
GraphQL is often praised for its human usability. However, can it rule the entire stack? Here's why Diana Suvorova believes GraphQL could dominate server-server communication as well. [nordicapis.com]
APIs Unplugged Episode 16 - HOLIDAY SPECIAL Season 1 Recap by MuleSoft
This episode looks back on Season 1 of the APIs Unplugged. Mike and Matt reflect on highlights from each episode, featuring special guests from all over the global API community. by MuleSoft [soundcloud.com]
A library for Go client applications that need to perform OAuth authorization against a server, typically GitHub.com. Traditionally, OAuth for web applications involves redirecting to a URI after the user authorizes an app. While web apps (and some native client apps) can receive a browser redirect, client apps such as CLI applications do not have such an option. by cli [github.com]
GitHub Action for APIMATIC Transformer
This Github Action uploads and converts any API Specification into one of the supported formats listed here, The user just need to use the GitHub action in their repository on GitHub and provide the API Specification URL and export format as the arguments to the action. by Mujtaba Mehdi [blog.apimatic.io]
The Business of APIs