System Design Card 377 — API Design / Assess
Concern
APIs reveal system boundaries, product semantics, idempotency, and the shape of client interaction. A create-notification endpoint should expose enough information about delivery state and retries to support real clients.
What Assess means for this concern
In BASIC, the Assess step is where you identify the main architectural pressures and choose which trade-offs are actually important. For API Design, that means the candidate should make this concern visible at the right moment instead of bolting it on at the end.
Design move
A good move is to compare plausible approaches before committing. Tie the concern back to the user flow, the workload, and the dominant trade-off. That keeps the design grounded and makes it easier for the interviewer to follow why a cache, queue, replica, partition, or rate limiter is actually necessary.
Common miss
The miss is staying at box level and never specifying how callers actually use the system. BASIC helps because the staged flow keeps this concern proportional to the prompt and connected to the rest of the architecture.
BASIC prompt
“When I reach the Assess stage, how does API Design change the architecture, the trade-offs, or the review checklist?”