stale · 0.1 capability schema

Best Practices

Score 14.9 / 100 12 providers +9 via APIs 12 APIs Search apis.io →

Providers using this tag (11)

Ranked by API Evangelist rating — Exemplar and Strong are expanded by default.

Strong 1 Solid coverage with minor gaps
Amazon Well-Architected ToolArchitectureCloud GovernanceWell-Architected1 API57.9
Developing 2 Usable, with meaningful gaps to close
Amazon Trusted AdvisorCloud OptimizationSecurity16 APIs46.9Microsoft Azure AdvisorAdvisorCost OptimizationMicrosoft Azure2 APIs45.5
Emerging 2 Early or largely undocumented
APIGovernance.DevAPI DesignAPI GovernanceCompliance1 API25.7Design PatternsObject-Oriented ProgrammingSoftware ArchitectureSoftware Engineering1 API12.5
Minimal 6 Almost no public developer surface
DevSecOpsApplication SecurityAutomationCI/CD4.1Secure-By-DesignArchitectureCybersecurityDesign Principles3.0Secure-By-DefaultDesign PrinciplesSecuritySecurity Architecture2.7Security by DesignDevelopment MethodologySecuritySoftware Development1.8ITILITSMITIL1.6Quality StandardsComplianceProcess ImprovementQuality Assurance1.6

APIs with this tag (11)

Ranked by the provider's API Evangelist rating — the Kin Score is scored per provider, not per API, so every API of a provider shares its band. How the rating works →

Exemplar 2 Complete, well-documented, and agent-ready
Microsoft Azure Best Practices APIThe Best Practices API from Microsoft Azure — 2 operation(s) for best practices.76.1Datadog Service Scorecards APIThe Service Scorecards API allows you to create and manage scorecard rules and outcomes. Scorecards help fo...70.1
Strong 1 Solid coverage with minor gaps
API Evangelist GuidanceModular guidance for teams producing and consuming APIs — snackable real-time guidance for keeping API oper...66.2
Developing 1 Usable, with meaningful gaps to close
Sweep Best Practices APIThe best-practices API from Sweep — 2 operation(s) for best-practices.52.2
Thin 1 Limited public surface area
OSPO GuidesA comprehensive collection of 23+ practitioner guides covering all aspects of running Open Source Program O...31.3
Emerging 6 Early or largely undocumented
APIGovernance.DevAPIGovernance.Dev provides automated API governance reviews using AI trained on 10,000 public APIs. It offe...25.7Microsoft Azure REST API GuidelinesMicrosoft's official REST API design guidelines for Azure services, covering resource naming, versioning, H...16.9Standards.RESTA curated collection of standards, conventions, and best practices for building RESTful APIs, including HAL...16.9Zalando RESTful API and Event GuidelinesZalando's comprehensive and widely-adopted RESTful API design guidelines, covering naming conventions, HTTP...16.9Shellharden APIAPI for correcting and hardening shell scripts for better reliability.15.6Richardson Maturity ModelA model by Leonard Richardson that breaks down the maturity of a RESTful API into four levels: Level 0 (The...14.6

Companies reaching this through an API (9)

These companies publish an API, specification or operation carrying “Best Practices” but do not classify their business under it. Listed unranked and kept out of the count above, because one tagged operation is not a statement about what a company does.

API Evangelist Datadog Microsoft Azure RESTful RESTful Services RSS Shell Scripting Sweep TODO Group

Score breakdown

Frequency
38.9
log-scaled weighted occurrences
Breadth
0.3
spread across providers
Quality lift
22.1
mean composite of providers using it
Cohesion
4.3
strength of nearest seed neighbor

Related tags

Architecture 5 co-occurrences Standards 6 co-occurrences Security 7 co-occurrences Compliance 5 co-occurrences

Where this tag comes from

Provider tag12
Api tag12
Openapi tag2
Openapi op tag6

Work with this as data

Every tag here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for tags

7 MCP tools reach this
  • find_tagsBrowse and filter every tag in the catalog.
  • get_cohortThis tag as a scored cohort — every provider carrying it, with scores.
  • cohort_statsPRO — the distribution across this tag: mean, median, band split, adoption rates.
  • cohort_rankingsPRO — the leaderboard, on composite AND agent-readiness axes.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This tag 
curl "https://apis.io/api/v1/tags/best-practices"
All tags 
curl "https://apis.io/api/v1/tags?limit=25"
As a scored cohort 
curl "https://apis.io/api/v1/cohorts/tag/best-practices"
The distribution (Pro) 
curl "https://apis.io/api/v1/cohorts/tag/best-practices/stats" \
  -H "X-API-Key: $APIS_IO_KEY"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.