coMakeIT - Xebia Logo
Thought Leadership

API-First Strategy

Increasingly businesses exist in a cloud-based, connected landscape that demands products and services which can be part of an ecosystem, that includes humans, devices, and applications, all of which generate and consume petabytes of data. In this landscape, humans-to-machines, machines-to-humans, and machines-to-machines interactions are taking place in an ever-expanding sphere. For e.g. your smartwatch, smartphone and you form a closed system where data and features are constantly being consumed and generated.

Therefore, any entity that aims to be a player in this ecosystem, must offer products and services that can be accessed and consumed on any device and deliver a seamless experience. This calls for applications with a flexible architecture that can be easily integrated with other apps, devices, and systems. The goal of any application or product should be as a participant in an ecosystem of services, rather than as a stand-alone monolithic application. The challenge is what design, processes, and practices can help build a successful product in such an environment.

The traditional code-first approach to building software applications is not the right way to cater to the needs of a connected ecosystem, in which integrations, interoperability, and modularity are primary business needs. In a code-first approach, even businesses that were using modular services, or Application Programming Interfaces (APIs), treated their development as a separate channel, which resulted in a contrived API, that is not well designed, thought out, leveraged or optimized.

A better approach is an API-first strategy. APIs allow businesses to break down capabilities into individual, autonomous services, and an API-first strategy enables you to build product features that can be used across multiple devices and channels.

An API-First Strategy means building APIs that encapsulates the business rules, process and value of a product first, and then building the product experience (user-facing) on top of it

With our strong product engineering expertise and technology insights, we at coMakeIT are ideally positioned to help businesses adopt an API-First strategy to build future-proof applications that are truly device and system-independent.

thought leadership 1

An API-First strategy to design and development of software applications offers numerous benefits, including asynchronous development, reduced development costs, faster time-to-market, lower risk of failure, and better metrics and metering. But an API-first strategy must be well-planned and should factor in key aspects, some of which are briefly described below:

Identify and partition Key Services 
We must identify at a broad level how to partition the key services of an end product. Each high-level collection of endpoints should be bundled as part of one business function. For e.g. for an e-commerce product: all item related endpoints such as to get item description, get the price, etc. Each high-level collection should have a stakeholder(s) and the owner(s) who can review the design of the API and also inform about how the interactions must take place from a feature perspective. These in turn will help to define the granularity of the API endpoints.

Define API endpoints
Once the high-level separation of API is defined, we must take each high-level concern and break it into granular endpoints that enable maximum reusability while ensuring that the number of endpoints are not increased beyond a reasonable limit. This has a direct effect on latency and speed of the service responses. If a feature can be done by one call to the API, it should be preferred over multiple calls to the API. This is frequently a trade-off and an optimal balance can be arrived by talking to the product stakeholders and UI/UX team.

Document API definition
Document all API endpoints. Preferably it should be auto-generated. For e.g. Swagger is a great tool that helps keep API definitions in sync with the code. As they say “Code is the Truth”!!!!. API definition document helps potential consumers of the API with how a request must be structured and all the possible return responses. This enables them to develop their application without any friction.

API Style Guide
A comprehensive, cohesive, and consistent style guide ensures service development teams across the organization adhere to the same API status codes, versioning, error handling, required (and optional) headers, etc.

Automated Tests
Any API that is built must be quality controlled through an automated suite of Unit, Regression, and Integration tests. This ensures that one doesn’t inadvertently break previous functionality or introduce new bugs, and also preserves the intent of the features from build to build. This is especially true if there are a lot of clients for the API, with their own special requirements. An automated test suite that runs as a part of your Continuous Development/Continuous Integration (CD/CI) pipeline is a must.

API versioning and backward compatibility policies should be set in place. API change is inevitable, and it is not a good idea to put away the way we are going to handle this to a later date. API versioning hell is a real thing if it is not thought through by version 1.0 of the API.

Developer Portal
Create a central, internal repository for developers, a place where all your API-related resources are stored- API specification, documentation, contracts, etc. For e.g. Atlassian’s confluence is a great tool for documentation and information distribution.

API-First Architecture
An indicative architecture of a product built with an API-first approach is shown below:

an api architeture new 600x400 1

header wave

10 technology trends to watch in the COVID-19 pandemic

During the COVID-19 pandemic, technologies are playing a crucial role in keeping our society functional in a time of lockdowns and quarantines. And these technologies may have a long-lasting impact beyond COVID-19. The COVID-19 pandemic has accelerated 10 key technology trends, including digital payments, telehealth and robotics, which can help reduce the spread of the coronavirus while helping businesses stay open.

Apple says the new MacOS Big Sur update is its biggest design change in almost 20 years

Apple on Monday introduced the new Big Sur version of its MacOS operating system for its laptops and desktops, with a big focus on updating the Safari web browser. The announcement came during Apple’s Worldwide Developers Conference, which for the first time took place as a virtual event due to the coronavirus pandemic.

The rollout of 5G in the Netherlands can continue, Court rules

Efforts by anti-5G campaigners to stop the nationwide roll-out of the faster telecommunications system in the Netherlands failed in court on Monday, when judges ruled there was no reason to stop the process. The Dutch state is not acting unlawfully by auctioning off the 5G frequencies and, the court said, the state has also said it will intervene if new insights show there are health risks.

EU states agree a tech spec for national coronavirus apps to work across borders

European Union countries and the Commission have agreed on a technical framework to enable regional coronavirus contacts tracing apps to work across national borders. A number of European countries have launched contacts tracing apps at this point, with the aim of leveraging smartphone technologies in the fight against COVID-19, but none of these apps can yet work across national borders.

Silicon Valley opposes Trump’s order on H-1B visas, say immigrants drive innovation

US President Donald Trump suspended H-1B and H-4 visas for the rest of the year, putting plans, jobs and the future of thousands in jeopardy. The executive order that Trump signed states that American workers compete against foreign nationals for jobs in every sector of the economy, including against millions of aliens (immigrants) who enter the United States to perform temporary work.

“Immigration has contributed immensely to America’s economic success, making it a global leader in tech, and also Google the company it is today. Disappointed by today’s proclamation – we’ll continue to stand with immigrants and work to expand opportunity for all” — Sundar Pichai (@sundarpichai)

Gartner Says Two-Thirds of Organizations Have Introduced New Wellness Benefits to Support Employees’ Mental and Emotional Well-being

Sixty-eight percent of organizations introduced at least one new wellness benefit by late March 2020 to aid employees during the COVID-19 pandemic, according to Gartner, Inc. As employees struggle to live within today’s new normal, leading to an increased amount of stress and anxiety, HR leaders must support employees holistically. “The COVID-19 pandemic has led more employees worldwide to seek assistance with their emotional and mental health,” said Carolina Valencia, director in the Gartner HR practice. “Organizations that are able to meet these new needs will become employers of choice for prospective job seekers.”

COVID-19 Has Pushed CIOs to Redefine IT Priorities

CIO roles and priorities have changed drastically due to the COVID-19 pandemic, forcing them to consider its long-term impact on their IT organizations and on business as a whole. COVID-19 Impact Study by IDG in mid-April said budgets would either hold steady or increase by next year. CIOs globally expected to have a renewed emphasis on operational efficiency, expense management, and cost controls. The survey also said that CIOs would minimize the focus on business collaboration, hiring, and training in the coming months.

How 26 Firms In APAC Changed Their Policies And Strategies To Support Customers In Tumultuous Times

The COVID-19 pandemic has shuttered businesses around the world, forcing millions of people to work from home and millions more into unemployment. As the economic effects of closures cascade, firms need to accommodate customers and partners with uncertain or reduced incomes — or lose their business entirely. Forrester published a new report which highlights how 26 firms in Asia Pacific are changing their policies and strategies to support their customers in these tumultuous times.

coMakeIT | co-innovate Newsletter 2020 Vol 3 Issue 2

A primer on API-First Strategy

API-First strategy is a great way to build future-proof products that are truly device and system-independent. Read this interesting blog by Sai Panyam on why businesses must embrace an API-First strategy.

Legacy Modernization: straddling the fence?

Read the latest blog by Shruthi Podduturi to get a better understanding of legacy challenges and to use a structured framework for choosing the right strategy to modernize your legacy systems.

Agile Swarming: Evolving beyond Scrum
Being truly agile is much more than merely following Scrum ceremonies.
Read this interesting blog by Phanindar Sirimuntha on our ‘agile evolution’ and adoption of innovative, advanced practices such as ‘agile swarming’.

Using IoT and Cloud technologies for safety solutions

This blog provides a overview of how personal wearables and mobile devices coupled with IoT and cloud technologies can be used to build sophisticated safety solutions to enhance people and workplace safety.

Guide to evaluate Low-code platforms

This blog presents an overview of the different capabilities that low-code platforms must have to build high performing, extensible, and future-ready apps. You can use these criteria to evaluate various low-code platforms and select the most appropriate platform to serve your current and future needs.

Communities are key to growth and scalability of ISVs

In this guest blog, Wilfried Rijsemus shares his insights on how ISVs can leverage the power of online communities to scale up.

coMakeIT | co-innovate Newsletter 2020 Vol 3 Issue 2

Lockdown Ki Kanhaiya: As the world went into lockdown in late March due to the COVID pandemic, and all of us shifted to remote working, we encouraged our colleagues to share their WFH experiences and stories through a unique initiative Lockdown ki kahaniya

lockdown 300x168 1

Voice of coMakeiT:  Work from home may be the new normal, but it doesn’t have to be boring. We continued to come up with innovative ways to bond and have fun, and we launched our own #digitalradio – Voice of coMakeIT to share our lockdown stories, experiences, and audio clips of anything we like. You can’t lockdown Innovation !!

Voice of CMI

Lending a helping hand to the Needy: Support to Connect and Madhunapantula foundations supported by coMakeIT donated groceries to 100+ families of the children attending the foundation school at #Pallipalem. Making sure the basics need of learning is not interrupted by the basic need of food in these times. Let’s continue to look out for each other!

Lending a helping hand to the Needy

Virtual Townhall: We hosted a virtual town hall meeting during the lockdown period and it was nice to see all #coMakeITians in absolutely great spirits, and serving our customers with undiminished enthusiasm. Kudos to ICT, HR and supporting teams who made the transition to the new normal and #WFH so effortless and seamless.

Virtual Townhall

Mother’s Day Celebration: When you look in the mirror, you partly see your mother – stated, Steven ten Napel, our founder and CEO. We hosted a virtual meet to celebrate the spirit of ‘Motherhood’ and share stories, experiences of the remarkable role that mothers played in shaping, influencing, and supporting us. You can watch the video of the event @

Mothers Day Celebration

Virtual Onboarding : It’s nice to see the excitement and enthusiasm of these bright youngsters who were virtually on-boarded during the lockdown period. We are delighted to welcome Ajay Kumar Maheshwari and Prudvi Raju Kallepalli to the coMakeIT family, and we wish them both personal success and professional fulfilment. Can’t wait to meet them in person!!

Virtual Onboarding

Mental Health Awareness Session: The unprecedented #COVID19 pandemic and the pressure of #WFH while dealing with the lockdown took a huge toll on #mentalhealth Last week, with the help of Pause for Perspective, we conducted a mental health awareness session to boost the morale and help coMakeIT employees learn techniques to overcome anxiety and manage stress.

Mental Health Awareness Session