{"openapi":"3.1.0","info":{"title":"鹿鸣川书籍搜索 API","version":"1.0.0","description":"搜索中文书籍元数据，并在可用时返回百度网盘或夸克网盘的公开直达链接。"},"externalDocs":{"description":"API 使用说明","url":"https://lunarora.com/api/"},"servers":[{"url":"https://lunarora.com"}],"paths":{"/api/v1/search":{"get":{"operationId":"searchBooks","summary":"搜索书籍","description":"按书名、作者或主题搜索。响应不记录下载统计；downloadLinks 中的 URL 为网盘直达链接。","parameters":[{"name":"q","in":"query","required":true,"description":"搜索词，2 到 80 个字符。","schema":{"type":"string","minLength":2,"maxLength":80},"example":"心理学"},{"name":"limit","in":"query","required":false,"description":"返回数量，默认 10，最大 100。","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"搜索成功。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"查询参数无效。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Catalog 搜索服务暂时不可用。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"DownloadLink":{"type":"object","additionalProperties":false,"required":["provider","url","extractionCode","description","fileSize","updatedAt"],"properties":{"provider":{"type":"string","enum":["quark","baidu"]},"url":{"type":"string","format":"uri"},"extractionCode":{"type":["string","null"]},"description":{"type":["string","null"]},"fileSize":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}}},"BookResult":{"type":"object","additionalProperties":false,"required":["type","title","authorsText","isbn","description","tags","rating","bookUrl","coverUrl","hasDownloadLinks","downloadLinks"],"properties":{"type":{"const":"Book"},"title":{"type":"string"},"authorsText":{"type":"string"},"isbn":{"type":"string"},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"rating":{"type":["number","null"]},"bookUrl":{"type":"string","format":"uri"},"coverUrl":{"type":["string","null"],"format":"uri"},"hasDownloadLinks":{"type":["boolean","null"]},"downloadLinks":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/DownloadLink"}},{"type":"null"}]}}},"SearchResponse":{"type":"object","additionalProperties":false,"required":["apiVersion","query","contentLanguage","count","limit","downloadLinksStatus","results"],"properties":{"apiVersion":{"const":"1"},"query":{"type":"string"},"contentLanguage":{"const":"zh-CN"},"count":{"type":"integer","minimum":0,"maximum":100},"limit":{"type":"integer","minimum":1,"maximum":100},"downloadLinksStatus":{"type":"string","enum":["available","temporarily_unavailable"]},"results":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/BookResult"}}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}