--- title: "The Six Facets Behind the API Evangelist Composite Score" url: https://daily.dev/posts/the-six-facets-behind-the-api-evangelist-composite-score-mfqkfcumu source_url: https://apievangelist.com/2026/08/24/the-six-facets-behind-the-api-evangelist-composite-score type: article source: "API Evangelist" published: 2026-08-24T12:23:40.868Z updated: 2026-08-24T12:24:03.674Z tags: ["architecture", "openapi"] reading_time: 4 upvotes: 0 comments: 0 language: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # The Six Facets Behind the API Evangelist Composite Score **[API Evangelist](https://daily.dev/sources/apievangelist)** · 4 min read · 0 upvotes · 0 comments ## Summary The API Evangelist Rating System's composite quality score breaks down into six weighted facets: Contract Quality (25%), Developer Ergonomics and Commercial Clarity (20% each), Operational Transparency (13%), Governance (12%), and Discoverability (10%). Contract Quality carries the most weight because specs like OpenAPI, AsyncAPI, and JSON Schema underpin everything else generated from them. Ergonomics and commercial clarity cover onboarding and machine-readable business terms. Operational transparency and governance track long-term reliability and linting outcomes, while discoverability, though cheap to game, rewards machine-readable metadata. Seventy-four individual checks feed into these six facets, and every weight is published so the score can be inspected and debated rather than taken as a black-box grade. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### What weight does contract quality carry in the API Evangelist Rating System's composite score? Contract quality carries twenty-five percent, the largest share of the six facets. It measures the technical depth of artifacts like OpenAPI, AsyncAPI, JSON Schema, and JSON-LD, including whether descriptions, error responses, and types are real rather than just present, because everything else—SDKs, mocks, agents, governance checks—is generated from or checked against that contract. _daily.dev surfaces API design and contract quality discussions for teams weighing their own spec standards._ ### How many individual checks make up the API Evangelist API rating score? Seventy-four individual checks feed into the six weighted facets (contract quality, developer ergonomics, commercial clarity, operational transparency, governance, and discoverability), each earned from an artifact the provider actually published, adding up to a composite score out of one hundred. _Developers evaluating API governance frameworks can track methodology breakdowns like this via daily.dev._ ### Why is API discoverability weighted lowest in a composite API quality score? Discoverability gets the smallest weight, ten percent, because although finding and understanding an API from machine-readable metadata (apis.yml completeness, tagging, identity signals) matters a lot, it is also the cheapest facet to max out. Weighting it low prevents a provider from earning a strong score by polishing metadata while shipping a weak underlying API. _daily.dev helps API practitioners compare governance and discoverability trade-offs across rating approaches._ ## Similar posts on daily.dev - [You Can Now Hire Me to Score Your API's Agent Readiness](https://daily.dev/posts/you-can-now-hire-me-to-score-your-api-s-agent-readiness-b3vbsjely) · API Evangelist · 2 upvotes · 0 comments - [The Six Quality Bands of the API Evangelist Rating System](https://daily.dev/posts/the-six-quality-bands-of-the-api-evangelist-rating-system-rclxgaolz) · API Evangelist · 0 upvotes · 0 comments - [I Stopped Building the Onboarding Fix. Now I Keep Score.](https://daily.dev/posts/i-stopped-building-the-onboarding-fix-now-i-keep-score--ka44ggbgi) · API Evangelist · 2 upvotes · 0 comments --- Tags: [#architecture](https://daily.dev/tags/architecture), [#openapi](https://daily.dev/tags/openapi) [View this post on daily.dev](https://daily.dev/posts/the-six-facets-behind-the-api-evangelist-composite-score-mfqkfcumu)