15 Best Practices for designing Enterprise RESTful APIs in cloud
API Gateway is a way to connect real-world cloud-ready applications. New applications need to design the data model and create public APIs to be consumed by mobile apps, third party apps, and different devices. We will explore best practices, which you must adopt to be cloud ready. Firstly, we will examine how contract first API development is helping enable more extensible and reliable APIs. Next, we will look at
We will ask tough questions during this design session.
- How to provide security? What are the best practices for authenticating?
- When should we version APIs? Should we use HATEOS for developing APIs?
- How to support internationalization?
- How to publish and maintain APIs?
We will take deep dive into the following areas:
- RESTful APIs design patterns:
- Principles for designing APIs, Hypermedia, Entity tags caching, filtering, Partial items, HAL
- API versioning techniques:
URI path, URI parameter, Content Negotiation, Request header - API Security:
Threats, Protecting APIs, Authentication, API Keys: How they work? SAML, OAuth and JSON Web Tokens - API Gateway:
Customer-driven contract development - API testing:
SoapUI, Postman
About Rohit Bhardwaj
Rohit Bhardwaj is Director of AI & Data Architecture at Salesforce, an O’Reilly instructor, and founder of AI Architect Circle. With 30 years of experience in software and enterprise architecture, he helps engineers, architects, and technology leaders make architecture decisions they can explain and defend.
His work brings together enterprise AI, agentic systems, data architecture, and distributed systems. He focuses on the decisions that determine whether a system remains reliable, secure, accountable, and economically sustainable when it encounters real-world demands.
Rohit’s talks and workshops explore practical questions: What happens when an AI agent acts on conflicting information? Can a failed payment be retried safely? Who can stop an autonomous action, and what evidence explains the decision afterward? His teaching connects these questions to architecture, customer trust, and business outcomes.
He is the author of System Design with AI Interview Guide: Designing Scalable, Agentic, and Defensible Systems, published by Apress. He also developed ARCHVIEW™, ROCS Loops™, and LLM-SHIELD™ to help teams structure architectural thinking and address the challenges of building trustworthy AI systems.
Through AI Architect Circle, Rohit extends this learning through live discussions, book walkthroughs, videos, and interactive architecture challenges. These challenges explore incidents such as payment timeouts and conflicting bookings, helping participants practice the judgment behind their design decisions.
Continue learning with Rohit
Join Rohit live on Saturdays at 9:00 a.m. Eastern
System Design with AI — Live with the Author is a free live podcast and Q&A series featuring practical system-design scenarios, AI architecture discussions, and questions from the community.
See the next session and register
Try an interactive architecture challenge
Put your design decisions under pressure and explore the consequences.
Explore the challenges
Explore AI Architect Circle
Find architecture lessons, videos, resources, and ways to continue learning.
Visit AIArchitectCircle.com
Read the book: Amazon · O’Reilly
Watch and connect: YouTube · Instagram: @aiarchitectcircle · LinkedIn · X / Twitter: @rbhardwaj1
More About Rohit »