{"openapi":"3.0.3","info":{"title":"移山可信知识站 Machine API","description":"Public read APIs for human-signed knowledge units. Empty catalogs are valid when the publication gate holds. All unit bodies share one release bundle (HTML/JSON/Markdown/cite).","version":"1.1.0"},"servers":[{"url":"https://knowledgemesh.geokeji.com"}],"paths":{"/api/v1/health":{"get":{"operationId":"getHealth","summary":"Service and publication readiness","responses":{"200":{"description":"Healthy or empty baseline ready"},"503":{"description":"Degraded"}}}},"/api/v1/query":{"get":{"operationId":"queryUnits","summary":"Lexical search over signed units","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":300}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}},{"name":"category","in":"query","schema":{"type":"string","maxLength":80}}],"responses":{"200":{"description":"Search hits (may be empty)"},"400":{"description":"missing_query or invalid_limit"}}}},"/api/v1/batch":{"post":{"operationId":"batchQueryUnits","summary":"Batch lexical search (max 10 queries)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["queries"],"properties":{"queries":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":300},"limit":{"type":"integer","minimum":1,"maximum":20},"category":{"type":"string","maxLength":80}}}}}}}}},"responses":{"200":{"description":"Per-query results"},"400":{"description":"invalid_body or too_many_queries"}}}},"/api/v1/units/{unitFile}":{"get":{"operationId":"getUnit","summary":"Fetch one signed unit as JSON or Markdown","parameters":[{"name":"unitFile","in":"path","required":true,"description":"{id}.json or {id}.md (id or slug accepted)","schema":{"type":"string","example":"unit-id.json"}}],"responses":{"200":{"description":"Unit body"},"404":{"description":"knowledge_unit_not_found"}}}},"/catalog.json":{"get":{"operationId":"getCatalog","summary":"Machine catalog of the current signed release","responses":{"200":{"description":"Catalog document"}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Short LLM discovery guide","responses":{"200":{"description":"text/plain"}}}},"/llms-full.txt":{"get":{"operationId":"getLlmsFullTxt","summary":"Full signed-unit index","responses":{"200":{"description":"text/plain"}}}},"/.well-known/ai-knowledge.json":{"get":{"operationId":"getCapabilityManifest","summary":"Capability and discovery manifest","responses":{"200":{"description":"Manifest JSON"}}}}},"components":{"schemas":{"MachineError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"requestId":{"type":"string","format":"uuid"}}},"KnowledgeUnit":{"type":"object","description":"Signed knowledge unit (status omitted in release bundle)","properties":{"id":{"type":"string"},"slug":{"type":"string"},"category":{"type":"string"},"canonicalQuestion":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"markdown":{"type":"string"},"applicableScope":{"type":"string"},"limitations":{"type":"string"},"constraints":{"type":"array","items":{"type":"string"},"description":"Optional structured constraints"},"skipIf":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"useInstead":{"type":"string"}},"required":["condition"]}},"version":{"type":"integer"},"contentHash":{"type":"string"},"verifiedAt":{"type":"string"},"reviewer":{"type":"string"}}}}}}