{"openapi": "3.1.0", "info": {"title": "GEEKSART Public Knowledge API", "version": "1.0.0", "description": "只读公开资料。无模型调用。未知适配条件、报价和档期须向团队确认。"}, "servers": [{"url": "https://www.geeks-art.com/aao"}], "paths": {"/manifest.json": {"get": {"operationId": "getCapabilities", "summary": "读取服务能力、使用边界与版本", "parameters": [], "responses": {"200": {"description": "Public source-grounded response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Capabilities"}}}}, "400": {"description": "Invalid request"}, "404": {"description": "Not found"}}}}, "/profile": {"get": {"operationId": "getProfile", "summary": "读取团队定位及合作方式", "parameters": [], "responses": {"200": {"description": "Public source-grounded response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RecordCollection"}}}}, "400": {"description": "Invalid request"}, "404": {"description": "Not found"}}}}, "/services": {"get": {"operationId": "getServices", "summary": "读取合作方式和工作流程", "parameters": [], "responses": {"200": {"description": "Public source-grounded response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RecordCollection"}}}}, "400": {"description": "Invalid request"}, "404": {"description": "Not found"}}}}, "/records": {"get": {"operationId": "searchRecords", "summary": "按关键词查询。空格分词取交集；默认排除历史记录", "parameters": [{"name": "q", "in": "query", "description": "作品名、别名或主题关键词，不是自然语言适配判定", "schema": {"type": "string", "maxLength": 200}}, {"name": "kind", "in": "query", "description": "资料类型", "schema": {"type": "string", "enum": ["artwork", "award", "company", "faq", "history", "project"]}}, {"name": "history", "in": "query", "description": "false排除历史；true包含；only仅历史", "schema": {"type": "string", "enum": ["false", "true", "only"], "default": "false"}}, {"name": "limit", "in": "query", "description": "每页条数", "schema": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}, {"name": "offset", "in": "query", "description": "分页偏移", "schema": {"type": "integer", "minimum": 0, "default": 0}}], "responses": {"200": {"description": "Public source-grounded response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SearchResult"}}}}, "400": {"description": "Invalid request"}, "404": {"description": "Not found"}}}}, "/records/{record_id}": {"get": {"operationId": "getRecord", "summary": "按公开ID读取全文与来源", "parameters": [{"name": "record_id", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Public source-grounded response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RecordResult"}}}}, "400": {"description": "Invalid request"}, "404": {"description": "Not found"}}}}}, "components": {"schemas": {"Source": {"type": "object", "required": ["title", "url"], "properties": {"title": {"type": "string"}, "url": {"type": "string", "format": "uri"}, "reviewed_on": {"type": "string", "description": "资料核对日期，非实时可用性验证"}}}, "Record": {"type": "object", "required": ["id", "title", "text", "kind", "status", "sources", "historical"], "properties": {"id": {"type": "string"}, "title": {"type": "string"}, "text": {"type": "string"}, "kind": {"type": "string"}, "role": {"type": "string"}, "attribution": {"type": "string"}, "interaction": {"type": "string"}, "boundary": {"type": "string"}, "event_year": {"type": "string"}, "valid_as_of": {"type": "string", "description": "事实核对日期，不代表在展、档期或价格"}, "status": {"type": "string", "enum": ["current_verified", "historical_verified"]}, "historical": {"type": "boolean"}, "operational_status": {"type": "string", "enum": ["not_confirmed", "not_applicable"]}, "body": {"type": "array", "items": {"type": "string"}}, "aliases": {"type": "array", "items": {"type": "string"}}, "sources": {"type": "array", "minItems": 1, "items": {"$ref": "#/components/schemas/Source"}}}}, "RecordCollection": {"type": "object", "required": ["records", "master_revision", "policy"], "properties": {"records": {"type": "array", "items": {"$ref": "#/components/schemas/Record"}}, "master_revision": {"type": "string"}, "policy": {"type": "object"}}}, "SearchResult": {"allOf": [{"$ref": "#/components/schemas/RecordCollection"}, {"type": "object", "properties": {"total": {"type": "integer"}, "offset": {"type": "integer"}, "limit": {"type": "integer"}, "query": {"type": "string"}, "matching": {"type": "string"}}}]}, "RecordResult": {"type": "object", "required": ["record", "master_revision", "policy"], "properties": {"record": {"$ref": "#/components/schemas/Record"}, "master_revision": {"type": "string"}, "policy": {"type": "object"}}}, "Capabilities": {"type": "object", "required": ["name", "version", "master_revision", "policy"], "properties": {"name": {"type": "string"}, "version": {"type": "string"}, "master_revision": {"type": "string"}, "record_counts": {"type": "object"}, "policy": {"type": "object"}, "mcp_available": {"type": "boolean"}}}}}}