Basic Framework
Implementsystem-designresearch-cardSystem Design

System Design Card 379 — API Design / Implement

API Design — BASIC step map

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.

Check your work like someone else wrote it.

What Implement means for this concern

In BASIC, the Implement step is where you walk the design into existence in a controlled order, deepening the risky parts first. 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 transcribe the plan instead of improvising. 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 Implement stage, how does API Design change the architecture, the trade-offs, or the review checklist?”

Practical tip
Narrate as you implement. Not every line — but the key decisions. 'I'm initializing the visited set here because...' or 'This handles the empty input case we discussed.' It connects your code back to your reasoning and gives the interviewer anchor points.

References

S9 S14 S15

Related in System Design

January 16, 2023

BASIC for system design interviews: the most reliable sequence for thinking at architecture scale

System design interviews are not just “bigger coding interviews.”

April 10, 2025

System Design Card 356 — Requirements Clarification / Breakdown

Every design starts with defining what must be true for the system to be considered successful. A notification system for security alerts is a different system from a marketing…

April 12, 2025

System Design Card 357 — Requirements Clarification / Assess

Every design starts with defining what must be true for the system to be considered successful. A notification system for security alerts is a different system from a marketing…