AI Apidocs — API Documentation Portal

• *rea:*Intelligence
• *ath:*services/ai/apidocs
• *ind:*Aggregated API documentation portal for AI services (rendered specs, code examples, try-it console)
• *tatus:*v0.0.1 — sector bootstrapping (20260509)

Role in the stack

apidocs is the developerfacing surface for the AI services — what platform.koder.dev is for product browsing, this sector is for API integration. Today external developers consuming gateway, voice, imaging, etc. have nowhere to read request/response shapes, no way to try a call without writing code, no place to copypaste an idiomatic Python or Go example. This sector pulls each AI sector's OpenAPI spec, renders consistently, generates idiomatic perlanguage code examples preferring the Koder SDK, embeds a tryit console wired to staging, and surfaces version selector + changelog.

It is the Koder analog of docs.anthropic.com, platform.openai.com/docs, Mintlify, and Redoc — built on a vetted FOSS base with full ownership of the generator (no SaaS lock-in).

Boundary vs neighbors

• platform.koder.dev is the *atalog*site (browseanddiscover); apidocs is the *ntegration*site.
• meta/sites/ holds institutional/marketing landings (www.koder.dev); apidocs is developer-facing.
• Each AI sector backend produces its /openapi.yaml; apidocs aggregates them.
• infra/net/jet hosts the rendered static site at docs.koder.dev.
• services/ai/playground integrates: try-it runs can be saved to playground for further iteration.

Features (v1 target)

• OpenAPI poller with normalization + perversion snapshots (kdbdoc backed)
• Static-site generator (Astro or Hugo, decision in impl #002) building deterministic bundle
• Persector and stackwide pages with version selector
• Code examples in curl + Python + Dart + Go, preferring Koder SDKs
• Interactive tryit console with staging proxy + shortlived tokens + rate limit
• Operationlevel + sectorlevel + stacklevel changelog with breakingchange classifier
• RSS feed + opt-in email digest
• Savetoplayground action from try-it
• Fulltext search (clientside)
• Light + dark theme + enUS/ptBR i18n

Primary couplings

RFC and bootstrap

• RFC: apidocs-RFC-001-foundations.kmd — *ccepted*20260509
• Bootstrap ticket: services/ai/backlog/done/138-apidocs-bootstrap.md
• Implementation tickets: services/ai/apidocs/backlog/pending/{001..005}

Selfhostedfirst analysis (5 gates)