‘Docs as code’ refers to the practice of writing documentation using the same tools and processes that developers use to write code. This means that documentation is : Authored using text files such as Markdown or LaTeX Version controlled using Git Updated by creating pull requests Published using CI/CD workflows Keeping Everything in Sync with […]
Working with APIs, I come across a lot of interesting feature requests. Among those, oneOf was something that a lot of the developers want, but scarce information is found on the topic. This blog will take you through my journey of how I acquainted myself with the role of “oneOf” in OpenAPI specifications. What is […]
Last week, we wrapped our API Developer Experience Meetup in San Francisco. Special thanks to Ashish Shubham from ThoughtSpot for sharing how to provide a good developer experience for SDKs, and to Joyce Lin for having us over at the new Postman office. The meetup included two talks from Adeel Ali, co-founder of APIMatic, and […]
In this API-centric era, you need to provide more than just an API. Providing a great developer experience with your API is the key to bridging a connection between a developer and an API provider. Offering a seamless developer experience for your API means that a developer can focus on what is important without dealing […]
While providing API documentation and SDKs with your API makes developer onboarding faster, it can be a challenge to keep up when your API is constantly evolving. You need to manually publish the documentation or SDKs on every API update, which can be a time consuming and repetitive task, prone to delays in releases. To […]
You create a great API and invest resources, time, and energy into it, but it turns out it’s not being adopted as much as you had anticipated. While your first instinct might be to investigate the API, there could be other factors at play here.. For starters, is your API documentation in-sync with the API? […]
Your mobile/Android application can talk to any API with the low-code approach through client SDKs. Client SDKs are independent internal libraries for your application that focus on the end-to-end flow for an API. They cut down the manual process of writing a whole client and related components, providing you with the best developer experience, and […]
Unsurprisingly, the pandemic-ridden era has fueled the rise of APIs in the world. What is more interesting, however, is that with the rise of APIs, a rise in the number of API specification documents has been observed as well. It leads us to believe that more people are adapting to the design-first approach for building […]
About 2 years ago, our lives changed overnight as the Covid-19 pandemic gripped the world. Now, as nearly everyone has received their vaccination shots, life has started to regain some normalcy. Schools have re-opened, meals can be enjoyed together and companies are slowly seeing employees back in the office. At APIMatic, we had moved to […]
