An API exposes a responsibility that another system can rely on. A useful boundary follows a stable business capability rather than the current arrangement of database tables. Internal storage can then change without requiring every caller to change with it.
InterfacesConnected infrastructure
Interfaces and recovery plans that survive ordinary failures.
Interfaces
An interface change is compatible only relative to the clients that use it. Adding a field can still break a strict parser, and adding an enum value can break an exhaustive switch. Compatibility needs evidence about real client behaviour.
InterfacesPagination divides a large result into smaller responses. If the underlying records change between requests, a caller may otherwise miss a record or see it twice. The ordering and consistency model are part of the interface contract.
InterfacesA request can cross several services before returning a response. Independent generous timeouts at every hop can make the total wait much longer than the caller expects. A deadline makes the remaining budget visible along the path.
InterfacesA webhook lets another system notify an endpoint when something changes. The public endpoint receives input from outside its trust boundary. Authentication, replay handling and input limits are therefore part of the message design, not optional finishing work.
InterfacesReliability
A running process is not necessarily ready to serve traffic. Conversely, a temporary dependency problem does not always mean restarting the process will help. Distinct health signals let the platform choose between waiting, removing traffic and restarting.
ReliabilityRepeated calls to an unhealthy dependency consume time and resources while adding pressure to the failing component. A circuit breaker temporarily rejects some calls after a defined failure pattern, then permits controlled probes to see whether service has recovered.
ReliabilityStopping a process can interrupt requests, lose unacknowledged work or cause clients to retry a completed action. A graceful shutdown sequence gives the process a bounded opportunity to finish or return ownership of its work before it exits.
ReliabilityA service can fail before its CPU is full. Connections, memory, queue slots or a downstream quota may become the limiting resource first. Capacity planning starts by identifying which resource bounds the workload and how demand grows with concurrency.
ReliabilityA recovery document is a hypothesis until someone follows it. A bounded drill checks whether people, access and procedures work together under realistic conditions. The goal is to discover missing steps before an outage makes every minute expensive.
Reliability