Mocking HTTP requests is a vital part of any testing regiment. The ability to test a wide range of possible situations, realities and use cases is extremely important, and it presents a great opportunity to really future proof your API. What tool you use to implement this does matter – your tool should be able to mock common API interactions and HTTP request flows, and most importantly, it should be appropriate to your given code base and situation. Read more
Building big platforms has always been difficult. Old-fashioned monolithic applications are plagued with slow delivery cycles, questionable reliability, and serious complexity. On the other hand, the microservices approach comes with complexities of its own, such as service overlap or unintended dependencies. Read more
There are plenty of reasons to name API endpoints thoughtfully. Choosing sensible names for API endpoints can drastically smooth out the learning curve for new developers, helping them intuitively know what to look for and where to find it. With that in mind, we’re dedicating this article to more than ten of the most effective best practices and conventions for naming API endpoints. Read more
We review Optic, a tool for auto-documenting and testing APIs
There are few things as important to the API developer experience as API specifications and API documentation. Both provide a vital conduit between the API provider and developer user, expressing critical information on functional aspects of the API. Read more
What’s your north star metric for developer relations?
Each developer relations program has a different opinion on what should be their north star metrics to measure the success of their platform. Some metrics are valid while others can be what are called vanity metrics. Read more
APIs are complex webs of interconnected applications, interfaces, frontends, and backends. Making sense of these systems is not always easy to do. When so much of the data coming into a system is from external sources that run the gamut from trusted to untrusted, known to unknown, the easiest way to classify that data is to classify it by the source origin – that is, to not talk about the nature of the data, but rather the nature of that which sent the data. Read more