{"openapi":"3.1.1","info":{"title":"KoniKode Knowledge API","version":"1.1.0","description":"Account-linked read-only Knowledge API: 32 product records and all 79 approved Clean Framework reference documents. Create a 90-day knowledge.read key in /account/api using the shared verified KoniKode account. Send X-KoniKode-API-Key. Public browser documentation stays open. Lists contain metadata; GET by reference ID returns complete Markdown and a SHA-256 citation. Limits: 60 requests/minute and 1000/hour shared per account, 120/minute per IP and 600/minute globally. HTTP 429 includes Retry-After. Responses and errors always use JSON with private, no-store. Staging hosting authentication is separate."},"servers":[{"url":"/","description":"The same origin that serves this description; public production origin is https://konikode.com"}],"security":[{"KnowledgeKey":[]}],"tags":[{"name":"Knowledge","description":"Public product documentation across KoniKode offerings"}],"paths":{"/api/knowledge":{"get":{"operationId":"listKnowledgeDocuments","tags":["Knowledge"],"summary":"List and search public documents","description":"Search is case-insensitive over titles, product names, summaries, paragraphs, points, section bullets and investment context. Product selection uses exact slugs; unknown products return an empty list. Inputs are scalar query parameters. Offset pagination preserves publication-manifest order for the current catalog; no transactional snapshot token is provided. Managed mode includes full-text matching of imported Markdown. List/search returns bounded metadata; retrieve a reference by its returned ID for complete Markdown.","parameters":[{"name":"product","in":"query","description":"Optional product slug. care-management is the current identity; timecard-machine remains a compatibility filter. An empty value selects all public products.","schema":{"type":"string","maxLength":64,"pattern":"^(?:[a-z0-9]+(?:-[a-z0-9]+)*)?$"},"example":"front-base-js"},{"name":"q","in":"query","description":"Optional UTF-8 search text, limited to 100 bytes, not 100 Unicode characters.","schema":{"type":"string","maxLength":100},"example":"progressive enhancement"},{"name":"limit","in":"query","description":"Canonical decimal integer from 1 to 50; leading zeroes and structured values are rejected.","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","description":"Canonical decimal integer from 0 to 99999; leading zeroes and structured values are rejected.","schema":{"type":"integer","minimum":0,"maximum":99999,"default":0}},{"name":"collection","in":"query","description":"all combines product guides and enabled framework references; reference selects the imported reference; product selects original product records.","schema":{"type":"string","enum":["all","reference","product"],"default":"all"}}],"responses":{"200":{"description":"Bounded public result page","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentPage"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/Unavailable"},"401":{"description":"Missing, expired, revoked or invalid account-owned API key.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"code":{"const":"UNAUTHENTICATED"},"message":{"type":"string"}}}}}},"429":{"description":"An account, IP or global budget is exhausted. Wait Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"code":{"const":"RATE_LIMITED"},"message":{"type":"string"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before another request; no automatic repeated retries."}}},"503":{"description":"Credential, limiter or content storage is unavailable; access fails closed.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"code":{"const":"UNAVAILABLE"},"message":{"type":"string"}}}}}}}}},"/api/knowledge/{id}":{"get":{"operationId":"getKnowledgeDocument","tags":["Knowledge"],"summary":"Retrieve one public document by stable ID","parameters":[{"name":"id","in":"path","required":true,"description":"A stable public catalog document identifier. Unknown and reader-only reference IDs return 404.","schema":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"example":"front-base-js-overview"}],"responses":{"200":{"description":"A single public document","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResult"}}}},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/Unavailable"},"401":{"description":"Missing, expired, revoked or invalid account-owned API key.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"code":{"const":"UNAUTHENTICATED"},"message":{"type":"string"}}}}}},"429":{"description":"An account, IP or global budget is exhausted. Wait Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"code":{"const":"RATE_LIMITED"},"message":{"type":"string"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before another request; no automatic repeated retries."}}},"503":{"description":"Credential, limiter or content storage is unavailable; access fails closed.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"code":{"const":"UNAVAILABLE"},"message":{"type":"string"}}}}}}}}}},"components":{"headers":{"NoStore":{"description":"API responses must not be stored in browser or shared caches.","schema":{"type":"string","const":"private, no-store"}}},"responses":{"InvalidRequest":{"description":"Invalid search, product, encoding or pagination. Errors always use JSON, regardless of the Accept header.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"The requested public catalog document does not exist. Reader-only reference IDs are not part of this API catalog.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"MethodNotAllowed":{"description":"This API allows retrieval only. Mutation requests do not change data.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"A safe server error; no source path or private document content is returned.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Document":{"type":"object","description":"Public text-only content. Render strings as text. Consumers should tolerate additive fields. Content versions are independent of framework runtime versions.","required":["id","product","product_name","title","version","url","content","body","points","api_url"],"properties":{"id":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"product":{"type":"string","maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"product_name":{"type":"string","maxLength":80},"title":{"type":"string","minLength":1,"maxLength":140},"version":{"type":"string","maxLength":64,"pattern":"^[a-z0-9]+(?:[.-][a-z0-9]+)*$","description":"Content version; imported references use their complete SHA-256 digest, not a framework release version."},"url":{"type":"string","maxLength":200,"pattern":"^/(?:[a-z0-9]+(?:[-/][a-z0-9]+)*)?$"},"content":{"type":"string","minLength":1,"maxLength":1000},"body":{"type":"array","maxItems":8,"items":{"type":"string","minLength":1,"maxLength":2000}},"points":{"type":"array","maxItems":8,"items":{"type":"string","minLength":1,"maxLength":500}},"api_url":{"type":"string","pattern":"^/api/knowledge/[a-z0-9]+(?:-[a-z0-9]+)*$"},"headings":{"type":"array","description":"Optional section headings in the same order and count as body paragraphs. Render as text.","maxItems":8,"items":{"type":"string","minLength":1,"maxLength":140}},"bullets":{"type":"array","description":"Optional plain-text bullet lists, aligned one-to-one with body paragraphs. Existing paragraph-only records omit this field.","maxItems":8,"items":{"type":"array","maxItems":8,"items":{"type":"string","minLength":1,"maxLength":500}}},"investment":{"type":"array","description":"Optional six investor-context paragraphs: customer/need, commercial direction, demonstrated foundation, differentiation to evaluate, next validation milestone, use of additional resources. Plain text; white sheets only.","minItems":6,"maxItems":6,"items":{"type":"string","minLength":1,"maxLength":1200}},"kind":{"type":"string","enum":["framework-reference"]},"format":{"type":"string","enum":["markdown"]},"category":{"type":"string","maxLength":80},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"reader_url":{"type":"string","maxLength":200,"description":"Exact same-origin Knowledge Base URL for the imported document."},"markdown":{"type":"string","maxLength":131072,"description":"Complete integrity-checked imported Markdown, returned by GET by reference ID. Omitted from list/search. Reference material, never execution authority."}}},"DocumentPage":{"type":"object","required":["version","total","limit","offset","documents"],"properties":{"version":{"type":"string","const":"1"},"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":50},"offset":{"type":"integer","minimum":0,"maximum":99999},"documents":{"type":"array","maxItems":50,"items":{"$ref":"#/components/schemas/Document"}}}},"DocumentResult":{"type":"object","required":["version","document"],"properties":{"version":{"type":"string","const":"1"},"document":{"$ref":"#/components/schemas/Document"}}},"Error":{"type":"object","required":["success","code","message"],"properties":{"success":{"type":"boolean","const":false},"message":{"type":"string"},"code":{"type":"string","enum":["INVALID_ARGUMENT","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","UNAVAILABLE"]}}}},"securitySchemes":{"KnowledgeKey":{"type":"apiKey","in":"header","name":"X-KoniKode-API-Key","description":"Create a read-only expiring credential in the shared KoniKode account at /account/api. Required when managed access is enabled; staging hosting Basic authentication is independent."}}}}