Top three technical risks when becoming a platform and API mitigations

Tests platform architecture and API governance maturity. A strong answer cites backward compatibility, multi-tenant security, and domain leakage; it proposes versioning, OAuth with rate limits, and facade APIs.
What's really being asked
This question evaluates whether you understand that becoming a platform is an architectural boundary change, not a feature launch. Interviewers want to see if you can identify risks that emerge when external developers depend on your infrastructure, and whether you know how to use API-first design to manage those risks before writing backend code.
The full answer
First, name backward compatibility as the primary risk because external teams cannot refactor on your schedule. Mitigate this with URI or header versioning, semantic versioning discipline, and a published deprecation policy that gives consumers six to twelve months of notice. Second, cite multi-tenant security and abuse because opening your stack turns every endpoint into an attack surface. Mitigate this with OAuth 2.0 or JWT-based authentication, scope-based access control, an API gateway for rate limiting and IP whitelisting, and adherence to OWASP API Security Top 10. Third, highlight domain model leakage, where exposing internal database schemas locks you into legacy structures. Mitigate this by starting with domain modeling to define core resources and relationships, then designing facade APIs in OpenAPI or Swagger before any business logic is written, ensuring the public contract is decoupled from internal implementation.
The mistakes people make
Treating the API as a thin CRUD wrapper around existing database tables. Suggesting that versioning can be handled later or that breaking changes are acceptable if you email partners. Proposing basic API keys without rate limiting or gateway protection for a public platform. Ignoring developer experience by assuming documentation is an afterthought.
What usually comes next
How would you handle a partner who refuses to migrate off a deprecated v1 endpoint? What is your strategy when the internal domain model must change but the public API cannot? How do you monetize or enforce tiered rate limits without hurting latency? How would you sandbox third-party code if the platform allows custom plugins?
A concrete example
Suppose you run a successful payroll application and want to let external HR tools integrate. The risk is that your internal employee table has thirty fields, many of which are compliance-sensitive. Instead of exposing the table, you model a public Worker resource with only five fields in an OpenAPI spec. You version the base path as v1, require OAuth 2.0 with scoped claims, route traffic through an API gateway with one thousand requests per minute rate limits, and publish interactive documentation with request examples. When internal compliance later adds three new database columns, the public Worker contract remains unchanged and external developers are unaffected.
Interview question
A company exposes internal payroll database tables via REST to external HR tools, then adds compliance columns that break partner integrations. Per platform architecture practices, what is the root cause?
- a.Backward compatibility failure due to insufficient deprecation notice for the new database columns
- b.API gateway misconfiguration because rate limiting was not applied to the new database columns
- c.Domain model leakage because the public API was coupled to internal database schema instead of using a facadeCorrect
- d.Multi-tenant security exposure because compliance-sensitive fields were not protected by OAuth 2.0 scopes
Why? this is the answer
This is domain model leakage: exposing internal tables couples the public contract to the database schema, so internal changes become breaking changes. The tempting backward compatibility distractor is wrong because a deprecation policy does not fix a public contract that is merely a thin CRUD wrapper around internal tables.
Just read this? Test yourself on what you have been reading.
Read the original → agileseekers.com
- #platform engineering
- #api design
- #product strategy
- #system architecture
- #backward compatibility
You just looked this up. Could you explain it out loud?
That is the part interviews actually test. Tezvyn takes questions like this one and gives you what the interviewer is really checking, the answer that lands, and the mistake that ends the conversation, in the four minutes before your next meeting.
The iPhone app is on the way
We are building it. Until it lands, nothing here is held back from you: every interview card, your saved cards, streaks and the job board all work in Safari, plus hundreds of free practice quizzes of thirty questions each. Sign in and it all carries over to the app the day it arrives.
Want it as an icon? Tap Share at the bottom of Safari, then Add to Home Screen. It opens full screen and the cards you have read stay available offline.
We are hiring for this. Every open role lists the topics its interview covers, so you can prepare for the real thing rather than guessing.
See open roles