{"adoption": {"forks": 2694, "observed_at": "2026-08-28T04:11:34.683982+00:00", "stars": 23327}, "canonical_url": "https://ross.abutalabs.com/products/api-guidelines", "card": {"archived": false, "artifact_type": "learning-resource", "description": "Microsoft REST API Guidelines", "domain": ["apis", "documentation", "web-development", "developer-tools"], "enriched": true, "function": ["api-framework", "documentation"], "health_score": 78, "homepage": null, "language": null, "license": "NOASSERTION", "license_family": "other", "maturity": "active", "member_repos": ["microsoft/api-guidelines"], "name": "microsoft/api-guidelines", "platform": ["cloud"], "pushed_at": "2026-08-05T00:07:38+00:00", "repo": "microsoft/api-guidelines", "stars": 23327, "tags": ["rest-api", "styleguide", "api-design", "guidelines", "microsoft", "web-server"], "topics": ["api", "guidelines", "rest-api", "styleguide"], "urls": [], "use_cases": ["design a consistent rest api", "learn api design best practices", "create api style guidelines for my organization", "naming and versioning conventions for rest endpoints", "error handling conventions for http apis", "review an api design against industry guidelines"], "what_it_is": "Microsoft's published REST API Guidelines, a set of documents describing conventions and best practices for designing REST APIs, with companion guidance for Azure and Microsoft Graph service teams. It is a reference resource rather than executable software.", "when_to_avoid": ["you need executable tooling like linters or code generators", "you are building GraphQL or gRPC APIs", "you need a formal specification rather than prose guidance"], "when_to_choose": ["you are designing or reviewing a REST API and want authoritative conventions", "you are building Azure or Microsoft Graph services", "you want a template for writing your own API guidelines"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/api-guidelines", "repo": "microsoft/api-guidelines", "role": "main", "score": 75}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:11:34.683982+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T16:56:44.985529+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a3702d249e51f919aa0a3547e44433f959daf6400912625be92f914c3d53c35e", "fetched_at": "2026-08-28T04:11:34.683982+00:00", "kind": "readme", "missing": false, "url": "https://github.com/microsoft/api-guidelines"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 96, "longevity": 100, "rhythm": 35}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["no_releases", "no_license"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 3704, "days_push": 29, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 75, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}