正在加载内容...

963963 Chat Feed Portal Independent coverage of news

API Design Explained Without the Jargon

By Sarah Jenkins · · 1327 words
API Design Explained Without the Jargon

Pay attention to the conditions around the conversation. A substantial power difference, financial dependence or fear of someone’s reaction can make it harder to speak openly. These circumstances do not automatically determine a legal outcome, but they are reasons to take extra care and avoid pressuring the other person. Give them time and a genuine opportunity to say no.

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

Monitoring Alerts: A queue smooths spikes but also hides how far behind you are. Monitoring Alerts: Retries without jitter turn a small outage into a large one. Monitoring Alerts: Separating the reads from the writes buys room to change either side.

For cloud infrastructure, the constraint matters more than the feature list. A queue smooths spikes but also hides how far behind you are. Teams working on cloud infrastructure usually discover this the hard way. Retries without jitter turn a small outage into a large one. Separating the reads from the writes buys room to change either side. This is most visible in cloud infrastructure.

In practice, content delivery behaves differently: 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. The same reasoning holds for content delivery. For content delivery, the constraint matters more than the feature list. Failures are usually correlated, so plan for the shared dependency.

Schema Markup: 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 schema markup as well. In practice, schema markup behaves differently: Failures are usually correlated, so plan for the shared dependency.

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

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.

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

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

A clinician may discuss whether a test is useful now or whether it should be repeated later. Tests can take time to detect an infection after exposure, and the relevant interval varies by infection and test. A negative result soon after a possible exposure may not settle the question. The service can explain the timing for the specific test and whether follow-up is appropriate.

The interesting number is not the average, it is the 99th percentile. The same reasoning holds for crawl budget. For crawl budget, the constraint matters more than the feature list. Adding a cache in front of a slow query is a fix; fixing the query is a cure. Teams working on crawl budget usually discover this the hard way. Every abstraction you add is a place where behaviour can differ from intent.

The interesting number is not the average, it is the 99th percentile. The same reasoning holds for schema migration. For schema migration, the constraint matters more than the feature list. Adding a cache in front of a slow query is a fix; fixing the query is a cure. Teams working on schema migration usually discover this the hard way. Every abstraction you add is a place where behaviour can differ from intent.

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: A design that cannot be rolled back is a design that cannot be changed safely. Backup Strategy: Latency budgets are easier to defend when every hop has a stated ceiling. Backup Strategy: Caching helps only until the invalidation rules become the bottleneck.

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

Before testing, a person can ask which infections are being checked, which samples will be taken, when results are expected and how the service will contact them. They can also ask about confidentiality and how records are handled. Privacy rules, including exceptions and rules for different ages, vary by country and service; it is reasonable to ask the clinic to explain them before sharing information.

If the rollback plan needs a meeting, it is not a rollback plan. The same reasoning holds for backup strategy. For backup strategy, the constraint matters more than the feature list. Small pages that stay small are easier to keep fast than large ones made fast. Teams working on backup strategy usually discover this the hard way. Write the invariant down; otherwise it lives only in someone's memory.

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

A design that cannot be rolled back is a design that cannot be changed safely. That applies to data pipelines as well. In practice, data pipelines 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 data pipelines.

Pressure can also interfere with a free choice. Repeated requests after a refusal, threats, intimidation or using someone’s dependence or vulnerability to influence them are not respectful ways to seek agreement. Differences in authority or power can make it harder for a person to refuse, even without an explicit threat. A responsible check-in leaves room for an honest no and does not punish, shame or bargain with someone for setting a boundary.

Teams working on release process usually discover this the hard way. A design that cannot be rolled back is a design that cannot be changed safely. Latency budgets are easier to defend when every hop has a stated ceiling. This is most visible in release process. Consider release process specifically. Caching helps only until the invalidation rules become the bottleneck.

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

Check charging contacts and ports for moisture before reconnecting power. Do not charge a wet product, and do not insert a charging cable or plug into a damp port. If the manual gives a drying interval or a specific cleaning procedure for the port, follow it. For products with a cord, inspect the cable and connector for fraying, looseness or corrosion before each charging session; stop using a damaged charger and check the maker’s replacement guidance.

Related reading