API Design in Practice: Lessons From Real Deployments

Cloud Infrastructure: Serving static bytes is the cheapest thing you can do at the edge. Cloud Infrastructure: A schema is an interface; changing it is a migration, not an edit. Cloud Infrastructure: Track the denominator as carefully as the numerator.

A queue smooths spikes but also hides how far behind you are. This is most visible in rate limiting. Consider rate limiting specifically. Retries without jitter turn a small outage into a large one. Rate Limiting: Separating the reads from the writes buys room to change either side.

Queue Design: The first thing to settle is the failure mode, not the happy path. Queue Design: Measurements taken once are anecdotes; you need a baseline that repeats. Queue Design: Costs usually concentrate in a small number of operations, so find those first.

You can often replace a coordination problem with an idempotency key. That applies to cloud infrastructure as well. In practice, cloud infrastructure behaves differently: Anything that grows without a bound will eventually hit one. Documentation that is not tested tends to describe the previous version. The same reasoning holds for cloud infrastructure.

Consider schema migration specifically. Serving static bytes is the cheapest thing you can do at the edge. Schema Migration: A schema is an interface; changing it is a migration, not an edit. Track the denominator as carefully as the numerator. That applies to schema migration as well.

When someone says no or changes their mind, accept the answer without punishment or pressure. A calm response such as “Okay” helps show that their choice will be respected. They do not owe you an alternative activity, reassurance or a detailed explanation.

Cloud Infrastructure: Periodic jobs should be safe to run twice, because they will be. Cloud Infrastructure: You rarely need a new component to fix a boundary problem. Cloud Infrastructure: The signal you want is often already logged, just not aggregated.

Teams working on data pipelines usually discover this the hard way. The interesting number is not the average, it is the 99th percentile. Adding a cache in front of a slow query is a fix; fixing the query is a cure. This is most visible in data pipelines. Consider data pipelines specifically. Every abstraction you add is a place where behaviour can differ from intent.

If the rollback plan needs a meeting, it is not a rollback plan. That applies to crawl budget as well. In practice, crawl budget behaves differently: Small pages that stay small are easier to keep fast than large ones made fast. Write the invariant down; otherwise it lives only in someone's memory. The same reasoning holds for crawl budget.

Log Analysis: A design that cannot be rolled back is a design that cannot be changed safely. Log Analysis: Latency budgets are easier to defend when every hop has a stated ceiling. Log Analysis: Caching helps only until the invalidation rules become the bottleneck.

Listening is part of the conversation. Ask what the other person understands, and invite them to describe their own boundaries without treating the exchange as a negotiation in which every limit must be traded away. Open questions such as “What would help you feel comfortable?” can clarify expectations. If a question feels intrusive, either person can decline to answer it.

For schema migration, the constraint matters more than the feature list. Periodic jobs should be safe to run twice, because they will be. Teams working on schema migration usually discover this the hard way. You rarely need a new component to fix a boundary problem. The signal you want is often already logged, just not aggregated. This is most visible in schema migration.

The appointment often begins with questions about your health, sexual contacts and any symptoms. A clinician may ask about the kinds of contact you have had, the body sites involved, contraception, pregnancy possibility, previous test results and vaccination. These questions help determine which samples are useful; they are not a measure of anyone’s character. You can ask why a question is relevant or request that the conversation take place privately.

Crawl Budget: The interesting number is not the average, it is the 99th percentile. Crawl Budget: Adding a cache in front of a slow query is a fix; fixing the query is a cure. Crawl Budget: Every abstraction you add is a place where behaviour can differ from intent.

Search Indexing: If the rollback plan needs a meeting, it is not a rollback plan. Search Indexing: Small pages that stay small are easier to keep fast than large ones made fast. Search Indexing: Write the invariant down; otherwise it lives only in someone's memory.

For storage tiers, the constraint matters more than the feature list. If a metric has no owner, it will drift until it causes an incident. Teams working on storage tiers usually discover this the hard way. The cheapest optimisation is usually removing work nobody asked for. Aggregating at write time trades flexibility for predictable read cost. This is most visible in storage tiers.

Backup Strategy: You can often replace a coordination problem with an idempotency key. Backup Strategy: Anything that grows without a bound will eventually hit one. Backup Strategy: Documentation that is not tested tends to describe the previous version.

Consider content delivery specifically. The interesting number is not the average, it is the 99th percentile. Content Delivery: Adding a cache in front of a slow query is a fix; fixing the query is a cure. Every abstraction you add is a place where behaviour can differ from intent. That applies to content delivery as well.

A routine sexual-health screening is not one fixed set of tests. A clinician or sexual-health service usually asks about your health and possible exposures, then recommends tests based on your circumstances, local guidance and preferences. Screening can identify some infections before symptoms appear, but no single appointment checks for every sexually transmitted infection (STI).

Use statements about your own needs rather than trying to guess your partner’s intentions. You might say, “I’m comfortable with this, but not with that,” or, “I need us to stop if I say pause.” Be specific about what you mean by words such as “slow down” or “check in.” Ask your partner what they are comfortable with, and leave room for an answer without interrupting or arguing.

Storage Tiers: The first thing to settle is the failure mode, not the happy path. Storage Tiers: Measurements taken once are anecdotes; you need a baseline that repeats. Storage Tiers: Costs usually concentrate in a small number of operations, so find those first.

Teams working on edge caching usually discover this the hard way. You can often replace a coordination problem with an idempotency key. Anything that grows without a bound will eventually hit one. This is most visible in edge caching. Consider edge caching specifically. Documentation that is not tested tends to describe the previous version.

Screening is designed for people who may have an infection without knowing it; many STIs cause no noticeable symptoms. If someone has symptoms or has been told they may have been exposed, that is different from routine screening and should be discussed with a clinician. A screening appointment may need to include an assessment beyond the tests usually offered to someone without symptoms.

Queue Design: Configurations should be reviewable in a diff, not only in a console. Queue Design: The best time to add an index is before the table gets large. Queue Design: Failures are usually correlated, so plan for the shared dependency.