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 →

MongoDB and Partners: Building the AI Future, Together

If you’re like me, over the past year you’ve closely watched AI’s developments—and the world’s reactions to them. From infectious excitement about AI’s capabilities, to impatience with its cost and return on investment, every day has been filled with AI twists and turns. It’s been quite the roller coaster. During the ride, from time to time I’ve wondered where AI falls on the Gartner hype cycle, which gives "a view of how a technology or application will evolve over time." Have we hit the "peak of inflated expectations" only to fall into the "trough of disillusionment?" Or is the hype cycle an imperfect guide, as The Economist argues? The reality is that it takes time for any new technology—even transformative ones like AI—to take hold. And every advance, no matter how big, has had its detractors. A famous example is that of Picasso (!), who in 1968 said, “Computers are useless. They can only give you answers.” (!!) For our part, MongoDB is convinced that AI is a once-in-a-generation technology that will enhance every future application—a belief that has been reinforced by the incredible work our partners have shared at MongoDB’s 2024 events. Speeding AI development MongoDB is committed to helping organizations of all sizes succeed with AI, and one way we’re doing that is by collaborating with the MongoDB partner ecosystem to create powerful, user-friendly AI development tools and solutions. For example, Fireworks.ai —which is a member of the MongoDB AI Applications Program ecosystem —created an inference solution that hosts gen AI models and supports containerized deployments. This tool makes it easier for developers to build and deploy powerful applications with a range of easy-to-use tools and customization options. They can choose to use state-of-the-art, open-source language, image, and multimodal foundation models off the shelf, or they can customize and fine-tune models to their needs. Jointly, Fireworks.ai and MongoDB provide a solution for developers who want to leverage highly curated and optimized open-source models and combine these with their organization’s own proprietary data—and to do so with unparalleled speed and security. “MongoDB is one of the most sophisticated database providers, and it’s very easy to use,” said Benny Chen , cofounder of Fireworks.ai. "We want developers to be able to use these tools, and we want to work with providers who enable and empower developers." Nomic , another MAAP ecosystem member, also enables developers with best-in-class solutions across the entire unstructured data workflow. Their Embed offering, available through the Nomic API , allows users to vectorize large-scale datasets for use in text, image, and multimodal retrieval applications, including retrieval-augmented generation (RAG), using only their web browser. The Nomic-MongoDB solution is a highly efficient, open-weight model that developers can use to visualize the unstructured datasets they store in MongoDB Atlas . These insights help users quickly discover trends and articulate data-driven value propositions. Nomic also supported the recently announced vector quantization in MongoDB Atlas Vector Search , which reduces vector sizes while preserving performance. Last—but hardly least!—there’s our new reference architecture with MAAP partners AWS and Anthropic. Announced at MongoDB.local London , the reference architecture supports building memory-enhanced AI agents, and is designed to streamline complex processes and develop smarter, more responsive applications. For more—including a link to the code on Github— check out the MongoDB Developer Center . Making AI work for anyone and everyone The companies MongoDB partners with aren’t just making gen AI easier for developers—they’re building tools for everyone. For example, Capgemini has invested $2 billion in gen AI and is training 100,000 of its employees in the technology. GenYoda, a solution that helps insurance professionals with their daily work, is a product of this investment. GenYoda leverages MongoDB Atlas Vector Search to analyze large amounts of customer data, like policy statements, premiums, claims history, and health information. Using GenYoda, insurance professionals can quickly analyze underwriters’ reports to make informed decisions, create longitudinal health summaries, and streamline customer interactions to improve contact center efficiency. GenYoda can ingest 100,000 documents in just a few hours and respond to users’ queries in two to three seconds—a metric on par with the most widely used gen AI models. And it produces results: in one example, by using Capgemini’s solution an insurer was able to increase productivity by 15%, add new reports 25% faster (thus speeding decision-making), and reduce the manual effort of searching PDFs, increasing efficiency by 10%. Building the future of AI together So, what’s next? Honestly, I’m as curious as you are. But I’m also incredibly excited. At MongoDB, we’re active participants in the AI revolution, working to embrace the possibilities that lie ahead. The future of gen AI is bright, and I can’t wait to see what we’ll build together. To learn more about how MongoDB can accelerate your AI journey, explore the MongoDB AI Applications Program .

November 4, 2024