Message from CEO
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.
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.
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.
An indicative architecture of a product built with an API-first approach is shown below:
News you can use
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 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.
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.
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.
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)
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.”
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.
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.
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.
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’.
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.
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.
News about coMakeIT
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 !!
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!
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.
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 @ https://youtu.be/zQn_k4b2pJY
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!!
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.