Publishing details regarding the performance of APIs, complimenting status and uptime information, but drilling into more detail regarding speed, latency, and other performance related metrics that matter to API consumers.
Performance
Rules
APIs.json Apis Properties Performance Info
This property ensures that an API has performance testing in place, providing a URL to the performance testing, dashboard, or other resource
Strategies
APIs Are Always High Quality and Reliable
All APIs should be high quality and reliable, providing adequate levels of monitoring of its availability and performance, with the proper provenance and communication with producer and consumers r...
APIs Are Observable and Monitored
All APIs must have comprehensive observability including monitoring, logging, health checks, and alerting, with defined SLIs and SLOs that ensure teams can proactively detect, diagnose, and resolve...
APIs Earn and Maintain Consumer Trust
All APIs must demonstrate trustworthiness through transparent service level commitments, consistent deprecation policies, reliable performance, proper security, and clear legal terms, building the ...
Experiences
Automation
Automating business operations is a primary driver for adopting and governing APIs, enabling organizations to achieve the scale, speed, and quality needed to remain competitive in global markets. A...
Communication
Consistent communication about the production and consumption of APIs is critical for effective enterprise governance. APIs are inherently difficult to visualize, making it essential to invest in m...
Quality
The quality of HTTP APIs powering an enterprise tends to decline as the number of ungoverned APIs grows across internal, partner, and public landscapes. Low-quality APIs lead to poor downstream exp...
Reliability
If an API isn’t reliable, consumers will eventually look for alternatives. Reliability starts with the platform and infrastructure where the API is deployed, but it also depends heavily on the pace...
Lifecycle
monitoring Monitoring Production
Monitoring is how I keep a promise of reliability. Uptime checks, health endpoints, and alerting tell me an API is doing its job before consumers have to tell me it is not. Monitoring is the differ...
speed Performance Production
Performance is a feature. Latency, throughput, and consistency directly shape how consumers experience an API and whether they keep using it. I measure performance continuously so that regressions ...