SDFrame Developer Portal
Developer portal for the SDFrame public read API, OpenAPI specification, AI skill package, authentication model, rate-limit guidance, and static integration points.
Quickstart
The SDFrame API is a public read-only API served as static JSON. Fetch the compact index first, then fetch an individual framework only when you need full detail.
curl https://sdframe.caldis.me/api/frameworks.index.json
curl https://sdframe.caldis.me/api/frameworks/domain-driven-design.jsonAuthentication
No authentication is required. There are no API keys, OAuth clients, user accounts, or write endpoints. This is intentional: SDFrame is a public reference catalog, not a private data service.
Endpoints
| Endpoint | Purpose |
|---|---|
/openapi.json | OpenAPI 3.1 description. |
/api/frameworks.index.json | Compact searchable framework summaries. |
/api/frameworks.json | Complete framework records. |
/api/frameworks/{slug}.json | One framework record. |
/api/categories.json | Category metadata and counts. |
/status.json | Operational metadata. |
Error handling and retry
Known framework slugs return static JSON. Unknown slugs are handled by the static host and may return an HTML 404 page. Agents should validate slugs against /api/frameworks.index.json before requesting detail files. For transient host errors, retry after 5 seconds, 30 seconds, and 2 minutes. Cache successful responses.
MCP
A live MCP transport is not currently operated from this static deployment. The MCP server card at /.well-known/mcp/server-card.json documents the current manifest-only status. Agents should use OpenAPI, the static JSON API, and SKILL.md for now.