MACH Aligned for Retail: API-First

Silvio Sola
June 24, 2022 | Updated: September 9, 2024
#Retail

>> Announcement: Some features mentioned below will be deprecated on Sep. 30, 2025. Learn more.

Retailers must constantly evolve to meet growing customer expectations and remain competitive. Both their internal- and external-facing applications must be developed using principles that promote agility and innovation, moving away from siloed architectures.

As discussed in the first article of this series, the MACH Alliance promotes the development of modern applications through open tech ecosystems. MACH is an acronym that represents Microservices, API-first, Cloud-native SaaS, and Headless. MongoDB is a proud member of the Alliance, providing retailers with the tools to build highly flexible and scalable applications.

This is the second in a series of blog posts focused on MACH and how retail organizations can leverage this framework to gain a competitive advantage. In this article, we’ll discuss concepts relating to the second letter of MACH: API-first.

Read the first post in this series, "MACH Aligned for Retail: Microservices."

What is an API-first approach and why is it important?

An application programming interface (API) is a set of routines, protocols, and tools that allow applications, or services within a microservices architecture, to talk to each other. APIs can be seen as messengers that deliver requests and responses.

Applications built around APIs are said to be API-first. With this approach, the design and development of APIs come before the software implementation. Typically, an interface is created that is used to host and develop the API. The development team will then leverage the interface to build the rest of the application.

This methodology enables developers to have access to specific functionalities of external applications or other microservices within the same application, depending on their needs. It promotes reusability because functionalities are interoperable with mobile and other client applications.

In addition, applications developed with an API layer in mind can adapt to new requirements more easily because additional services and automation can be integrated into production when new requirements arise, therefore remaining competitive for longer.

*An API-first approach to developing applications*

The role of API-first in retail

APIs play a crucial role in deeply interconnected systems that need to interface with other internal applications, third-party partners, and customers — all key areas when it comes to developing powerful retail applications. Think about how an e-commerce platform connects to the different systems making up the purchase process, such as inventory management, checkout, payment processing, shipping, and loyalty programs.

The use of APIs is deeply interlinked with the concept of microservices. Software and data need to be decoupled to enable retailers to meet ever-increasing requirements, including omnichannel and cross-platform integration, seamless experiences across physical and online stores, and the ability to leverage real-time capabilities that enable differentiating features, such as live inventory updates and real-time analytics. APIs can be seen as a bridge for loosely coupled microservices to communicate with each other.

Besides enabling a microservices architecture, an API-first approach offers the following additional benefits:

Avoid duplication of efforts and accelerate time to market. Developers can work on multiple frontends at the same time, being confident that functionalities can be integrated by embedding the same APIs once ready. Think of multiple development teams working on an e-commerce web application, mobile portal, and internal inventory management system all at the same time. An API enabling the placement of a new order can be seamlessly leveraged by the web and mobile application and fed into the inventory management system to aid warehouse workers. Bug-fixing and feature enhancements can happen simultaneously, avoiding duplication of efforts and allowing new capabilities to be released to market more quickly.
Reduce risks and operating costs. An API-first approach enables system stability and interoperability from the beginning because API efficiency is placed at the center of the development lifecycle and is no longer an afterthought once the application or functionality has been developed. This approach reduces the risk for retailers and saves money and effort in troubleshooting unstable systems.
Enable new opportunities and scale faster. A flexible approach revolving around APIs provides more opportunities when it comes to integrating and refactoring the way different client applications and microservices communicate with each other, allowing retailers to improve and scale their IT offering in a fraction of the time. This approach also changes the way retailers can interact with external partners and do business with them since they can be provided with the tools to easily integrate with the retailer’s offering.
Achieve language flexibility. Effective retailers need to have the capability to adapt their digital offering to different regions and languages. The plug-in capabilities of API-first allow developers to offer language-agnostic solutions that different microservices can integrate with, leveraging region-specific frontends.

What is the alternative?

The four MACH Alliance principles combined (Microservices, API-first, Cloud-native SaaS, Headless) act as a disrupting force compared to the way applications were built until recently. Adapting to a new technology paradigm requires effort and a different developer mindset. But what was there before?

From an API-first perspective, it can be said that the opposite is code-first. With this approach, application development starts in the integrated development environment (IDE), in which code is written and the software takes shape. Development teams know that they will need to build an interface to be able to interact with each function of the code, but it is seldom a priority; developing core functionalities takes precedence over the interface where those functionalities will be hosted and accessed.

When the time comes for the interface to be developed, the code has already been defined. This means the API is developed around existing code rather than vice versa, which poses limitations. For example, developers might not be able to return data the way they want because of the underlying data schema.

Bottlenecks can also occur as other teams requiring the API will need to wait until the code is finalized to be able to embed it in their underlying applications. Any delays in the software development lifecycle will hold them up and delay progress. Although a code-first approach might have worked in the past, it is no longer suitable for dealing with highly interconnected applications.

Learn more about how MongoDB and MACH are changing the game for ecommerce.

How MongoDB helps achieve an API-first approach

Simply lifting and shifting monolithic applications to a microservice and API-first architecture will only provide minimal benefits if they are still supported by a relational data layer. This is where most of the bottlenecks occur. Changes to application functionalities will require constant refactoring of the database schemas, object-relational mapping (ORM), and refining at the microservice level.

Moving to a modern MACH architecture requires a modern data platform that removes data silos.

The MongoDB developer data platform provides a flexible data model, along with automation and scalability features to adapt to even the most challenging retail use cases and to multiple platforms (e.g., on-premises, cloud, mobile, and web applications).

MongoDB Atlas, MongoDB’s fully managed cloud database, also provides capabilities to manage the data layer end to end via APIs, such as the MongoDB Atlas Data API. This is a REST-like, resilient API for accessing all Atlas data that enables CRUD operations and aggregations with instantly generated endpoints. This is a perfect answer to an API-first approach, since developers can access their data using the same principles leveraged to connect to other applications and services.

MongoDB’s Atlas Data API provides several other benefits, allowing developers to:

Build faster with developer-friendly data access. Developers work with a familiar, REST-like query and response format, no client-side drivers are necessary.
Scale confidently with a resilient, fully managed API that reduces the operational complexity needed to start reading and writing your data.
Integrate your MongoDB Atlas data seamlessly into any part of your stack — from microservices to analytics workloads.

This article has provided only a sample of what can be leveraged via MongoDB’s APIs. The MongoDB Query API provides a comprehensive set of features to seamlessly work with data in a native, familiar way. It supports multiple index types, geospatial data, materialized views, full-text search, and much more. In the next part in this MongoDB and MACH Alliance series, we will discuss how a cloud-native SaaS architecture can enable full application flexibility and scalability.

Read the first post in this series, "MACH Aligned for Retail: Microservices."

← Previous

Launching Your Tech Career at MongoDB: 2 Interns Share Their Stories

Finding the right job in the tech industry isn’t easy. It’s even more challenging when you’re a new graduate or soon-to-finish college student trying to understand the opportunities for your career in tech. MongoDB aims to make that transition easier with its summer internship program and a new grad program that are designed to provide students and recent grads an opportunity to get their foot in the door of a growing tech company. Betsy Button, a MongoDB software engineer, participated in the MongoDB internship program in 2020. Betsy Button is a former intern from the class of 2020, and she now works full-time at MongoDB as a software engineer. Due to the COVID pandemic, Button’s internship was fully remote — a much different experience than past MongoDB internships. “While a remote internship would never have been my first choice experience, the MongoDB Campus Team’s dedication to making the most out of the summer shined through all of their virtual intern events, network programming, and frequent check-ins,” Button said. She said her challenging work as an intern prepared her for her full-time role today. “I really enjoyed the high-impact project that my intern team worked on throughout the summer,” she said. “Product managers estimated that our work saved the company a significant amount of money every month, which is an awesome outcome for ‘just an internship.’” Becoming a MongoDB Intern MongoDB’s summer internship program launched in 2011 with four interns and has grown to include more than 150 interns around the world working in over a dozen roles, from engineering to product design to marketing. Mentorship is the cornerstone of the MongoDB internship experience. Each intern is paired with a mentor on their team; a Campus Team mentor; and an optional Affinity Group mentor. Interns also participate in sessions that promote professional growth, including learning and development sessions, social events, a guest speaker series, and a roundtable discussion that allows them to meet with company executives and employees across different business units. MongoDB’s New Grad Program provides a seamless transition for interns to continue their career journeys with the company. “We view the 11-week internship program as an extension of the interview process,” said Natalie Chwalk, the program manager for early talent at MongoDB. “Our interns are our pipeline of future leaders at MongoDB, so we are evaluating them on performance as much as they are evaluating us as a potential employer.” Chwalk added: “The end goal is that we convert our interns to entry-level employees. This is the ultimate win-win because we are retaining strong talent, and the new grads are able to begin their careers with a company culture they know and love.” After graduating, software engineer enrollees have three options to choose from if they return to MongoDB to work full-time: Full rotation: The new graduate will rotate on three different engineering teams every six weeks, for 18 weeks total. At the end, the employee will be permanently placed with a team based on feedback, evaluations, and business needs. Department rotation: The new graduate will rotate on three teams within their department on different sub-teams for 18 weeks. At the end, they will be permanently placed with a team, based on the same criteria above. Direct to intern team: The new graduate returns directly back to their intern team. Tristan Wedderburn, a software engineer at MongoDB, found a permanent role after his MongoDB internship. Tristan Wedderburn is a former MongoDB intern and now a software engineer on the Atlas Serverless team at MongoDB. A highly complex project he worked on as an intern led him to realize how valuable the program was. “The project was technically challenging, and it was exciting to see the project shipped into production shortly after the internship, highlighting the impact that interns have the ability to make,” Wedderburn said. Wedderburn found the Affinity Group mentorship as a particularly valuable part of the intern program. “In our sessions, we would discuss technical concepts that I hadn’t been exposed to in my engineering classes, which was cool,” he said. As for what advice he would give to prospective interns and recent graduates? It’s on you to make the most of it, he said. “Your experience is directly related to how much you want to get out of it,” Wedderburn said. “Adopt a learning mindset and ask questions when you don’t understand things. Your team is there to support you.” Button agrees with how to make the most of your time as a MongoDB intern. “Take advantage of the networking opportunities available to interns,” she said. “The people at MongoDB are some of the brightest and kindest that I’ve ever met. It’s worth spending time getting to know others outside your team.” Interested in learning more about MongoDB’s opportunities for students and recent graduates? Check out our intern video or visit our Careers page .

June 23, 2022

Next →

Hanabi Technologies Uses MongoDB to Power AI Assistant, Hana

For all the hype surrounding generative AI, cynics tend to view the few real-world implementations as little more than “fancy chatbots.” But for Abhinav Aggarwal, CEO of Hanabi Technologies, the idea of a generative AI-powered bot that is more than just an assistant was intriguing. “I’d been using ChatGPT since it launched,” said Aggarwal. “That got me thinking: How could we make a chatbot that was like a team member?” And with that concept, Hana was born. The problem with bots “Most generative AI chatbots do not act like people; they wait for a command and give a response,” said Aggarwal. “We wanted to create a human-like chatbot that would proactively help people based on what they wanted—automating reminders, for example, or fetching time zones from your calendar to correctly schedule meetings.” Hanabi’s flagship product, Hana, is an AI assistant designed to enhance team collaboration within Google Chat, working in concert with Google Workspace and its suite of products. “Our target customers are smaller companies of between 10 and 50 people. At this size you’re not going to build your own agent from scratch,” he said. Hana integrates with Google APIs to deliver a human-like assistant that chimes in with helpful interventions, such as automatically setting reminders and making sure meetings are booked in the right time zone for each participant. “Hana is designed to bring AI to smaller companies and help them collaborate in a space where they are already working—Google Workspace,” Aggarwal explained. The MongoDB Atlas solution For Hana to act like a member of the team, Hanabi needed to process massive amounts of data to support advanced features like retrieval-augmented generation (RAG) for better information retrieval across Google Docs and many other sources. And with a rapidly growing user base of over 600 organizations and 17,000+ installs, Hanabi also required a secure, scalable, and high-performing data storage solution. MongoDB Atlas provided a flexible document model, built-in vector database, and scalable cloud-based infrastructure, freeing Hanabi engineers to build new features for Hana rather than focusing on rote tasks like data extract, transform, and load processes or manual scaling and provisioning. Now, MongoDB Atlas handles a variety of responsibilities: Scalability and security: MongoDB Atlas’s auto-scaling and automatic backup features have enabled Hanabi to seamlessly grow its user base without the need for manual database management. RAG: MongoDB Atlas plays a critical role in Hana’s RAG functionality. The platform enables Hanabi to split Google Docs into small sections, create embeddings, and store these sections in Atlas’s vector database. Development Processes: According to Aggarwal, MongoDB’s flexibility in managing changing schemas has been essential to the company’s fast-paced development cycle. Data Visualization: Using MongoDB Atlas Charts has enabled Hanabi to create comprehensive dashboards for real-time data visualization. This has helped the team track usage, set reminders, and optimize performance without needing to build a manual dashboard. Impact and results With MongoDB Atlas, Hanabi can successfully scale Hana to meet the demands of its rapidly expanding user base. The integration is also enabling Hana to offer powerful features like automatic interactions with customers, advanced information retrieval from Google Docs, and manually added memory snippets, making it an essential tool for teams around the world. Next steps Hanabi plans to continue integrating more tools into Hana while expanding its reach to personal Gmail users. The company is also rolling out a new automatic-interaction feature, further enhancing Hana’s ability to proactively assist users without direct commands. MongoDB Atlas remains a key component of Hanabi’s stack, alongside Google Kubernetes Engine, NestJS, and LangChain, enabling Hanabi to focus on innovating to improve the customer experience. Tech Stack MongoDB Atlas Google Kubernetes Engine NestJS LangChain Are you building AI apps? Join the MongoDB AI Innovators Program today! Successful participants gain access to free MongoDB Atlas credits, technical enablement, and invaluable connections within the broader AI ecosystem. If your company is interested in being featured, we’d love to hear from you. Connect with us at ai_adopters@mongodb.com.

November 21, 2024