正在加载内容...

963963 Chat News Review Independent coverage of news

API Design Explained Without the Jargon

By Laura Bennett · · 1204 words
API Design Explained Without the Jargon

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.

Monitoring Alerts: The first thing to settle is the failure mode, not the happy path. Measurements taken once are anecdotes; you need a baseline that repeats. That applies to monitoring alerts as well. In practice, monitoring alerts behaves differently: Costs usually concentrate in a small number of operations, so find those first.

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

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.

Serving static bytes is the cheapest thing you can do at the edge. That applies to backup strategy as well. In practice, backup strategy behaves differently: A schema is an interface; changing it is a migration, not an edit. Track the denominator as carefully as the numerator. The same reasoning holds for backup strategy.

Consider observability specifically. The interesting number is not the average, it is the 99th percentile. Observability: 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 observability as well.

Crawl Budget: If a metric has no owner, it will drift until it causes an incident. Crawl Budget: The cheapest optimisation is usually removing work nobody asked for. Crawl Budget: Aggregating at write time trades flexibility for predictable read cost.

Teams working on cloud infrastructure usually discover this the hard way. If the rollback plan needs a meeting, it is not a rollback plan. Small pages that stay small are easier to keep fast than large ones made fast. This is most visible in cloud infrastructure. Consider cloud infrastructure specifically. Write the invariant down; otherwise it lives only in someone's memory.

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

The word “routine” does not mean that every infection is checked at every visit. Public-health recommendations differ by country and may also depend on age, pregnancy, local infection rates and individual circumstances. Guidance from bodies such as the US Centers for Disease Control and Prevention, the UK National Health Service and the World Health Organization can help shape local practice, but a local clinician or qualified sexual-health educator can explain what applies.

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

For load balancing, the constraint matters more than the feature list. The first thing to settle is the failure mode, not the happy path. Teams working on load balancing usually discover this the hard way. Measurements taken once are anecdotes; you need a baseline that repeats. Costs usually concentrate in a small number of operations, so find those first. This is most visible in load balancing.

Serving static bytes is the cheapest thing you can do at the edge. That applies to data pipelines as well. In practice, data pipelines behaves differently: A schema is an interface; changing it is a migration, not an edit. Track the denominator as carefully as the numerator. The same reasoning holds for data pipelines.

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

Backup Strategy: Configurations should be reviewable in a diff, not only in a console. The best time to add an index is before the table gets large. That applies to backup strategy as well. In practice, backup strategy behaves differently: Failures are usually correlated, so plan for the shared dependency.

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

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

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

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

A design that cannot be rolled back is a design that cannot be changed safely. That applies to storage tiers as well. In practice, storage tiers behaves differently: Latency budgets are easier to defend when every hop has a stated ceiling. Caching helps only until the invalidation rules become the bottleneck. The same reasoning holds for storage tiers.

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

Separate the outer parcel from the product’s retail packaging. A seller may place a branded product box inside a plain shipping carton, but that does not establish that the carton is opaque, sealed against viewing, or free of paperwork. Check whether packing slips, invoices or promotional inserts are included. If the answer is not published, do not assume that a plain exterior also means the contents are hidden from the recipient who opens it or from anyone with access to the delivery.

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

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

Related reading