{"openapi":"3.1.0","info":{"title":"小谈 API","version":"1.0.0","description":"零数据库内容与 Emoji API。数据版本 03d52e1ea37a5dd4。不依赖登录；外部图片可用性与索引查询独立。"},"servers":[{"url":"/"}],"paths":{"/api/v1/iching/hexagrams":{"get":{"operationId":"iching","summary":"周易六十四卦","description":"按文王卦序分页返回六十四卦摘要，可检索卦名、序号、卦符与上下卦；经文请按卦序读取。","parameters":[{"name":"q","in":"query","required":false,"description":"按文王卦序、卦名（支持简繁）或卦符检索。","schema":{"type":"string","maxLength":40,"default":""}},{"name":"upper","in":"query","required":false,"description":"all 为全部；qian 乾、dui 兑、li 离、zhen 震、xun 巽、kan 坎、gen 艮、kun 坤。","schema":{"type":"string","enum":["all","qian","dui","li","zhen","xun","kan","gen","kun"],"default":"all"}},{"name":"lower","in":"query","required":false,"description":"按下三爻构成的经卦筛选，枚举与上卦相同。","schema":{"type":"string","enum":["all","qian","dui","li","zhen","xun","kan","gen","kun"],"default":"all"}},{"name":"page","in":"query","required":false,"description":"从 1 开始的页码，超出数据页返回空列表。","schema":{"type":"integer","minimum":1,"maximum":1000000,"default":1}},{"name":"pageSize","in":"query","required":false,"description":"目录仅返回摘要，每页最多 32 卦。","schema":{"type":"integer","minimum":1,"maximum":32,"default":12}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer","minimum":1,"maximum":64},"name":{"type":"string","minLength":1},"symbol":{"type":"string","minLength":1,"maxLength":1},"linesBottomUp":{"type":"array","prefixItems":[{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]}],"items":false,"minItems":6,"maxItems":6},"lowerTrigram":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]},"upperTrigram":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]}},"required":["number","name","symbol","linesBottomUp","lowerTrigram","upperTrigram"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","exclusiveMinimum":0,"maximum":100},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["page","pageSize","total","totalPages"],"additionalProperties":false}},"required":["items","pagination"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/hitokoto":{"get":{"operationId":"hitokoto","summary":"随机一言","description":"从版本化本地内容查询，无需账户。","parameters":[{"name":"category","in":"query","required":false,"description":"all 为全部；a 动画 / b 漫画 / c 游戏 / d 文学 / e 原创 / f 网络 / g 其他 / h 影视 / i 诗词 / j 网易云 / k 哲学 / l 抖机灵。","schema":{"type":"string","enum":["all","a","b","c","d","e","f","g","h","i","j","k","l"],"default":"all"}},{"name":"format","in":"query","required":false,"description":"JSON 或纯文本；错误始终返回 JSON。","schema":{"type":"string","enum":["json","txt"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"uuid":{"type":"string"},"text":{"type":"string","minLength":1},"category":{"type":"string","enum":["a","b","c","d","e","f","g","h","i","j","k","l"]},"source":{"type":["string","null"]},"author":{"type":["string","null"]}},"required":["id","uuid","text","category","source","author"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/answerbook":{"get":{"operationId":"answerbook","summary":"答案之书","description":"从版本化本地内容查询，无需账户。","parameters":[{"name":"format","in":"query","required":false,"description":"JSON 或纯文本；错误始终返回 JSON。","schema":{"type":"string","enum":["json","txt"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1}},"required":["id","text"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/crazythursday":{"get":{"operationId":"crazythursday","summary":"疯狂星期四","description":"从版本化本地内容查询，无需账户。","parameters":[{"name":"format","in":"query","required":false,"description":"JSON 或纯文本；错误始终返回 JSON。","schema":{"type":"string","enum":["json","txt"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1}},"required":["id","text"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/emoticon":{"get":{"operationId":"emoticon","summary":"颜文字","description":"从版本化本地内容查询，无需账户。","parameters":[{"name":"format","in":"query","required":false,"description":"JSON 或纯文本；错误始终返回 JSON。","schema":{"type":"string","enum":["json","txt"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1}},"required":["id","text"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fafeng":{"get":{"operationId":"fafeng","summary":"发疯文学","description":"从版本化本地内容查询，无需账户。","parameters":[{"name":"target","in":"query","required":false,"description":"替换文案中的 {target_name}，作为纯文本处理。","schema":{"type":"string","maxLength":32,"default":"你"}},{"name":"format","in":"query","required":false,"description":"JSON 或纯文本；错误始终返回 JSON。","schema":{"type":"string","enum":["json","txt"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1}},"required":["id","text"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/jrys":{"get":{"operationId":"jrys","summary":"今日运势","description":"从版本化本地内容查询，无需账户。","parameters":[{"name":"luck","in":"query","required":false,"description":"随机抽签；good 为至少四颗实星，bad 为不足四颗，不承诺同一人当天固定。","schema":{"type":"string","enum":["all","good","bad"],"default":"all"}},{"name":"format","in":"query","required":false,"description":"JSON 或纯文本；错误始终返回 JSON。","schema":{"type":"string","enum":["json","txt"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1},"summary":{"type":"string"},"stars":{"type":"integer","minimum":0,"maximum":7},"starText":{"type":"string"},"sign":{"type":"string"},"explanation":{"type":"string"},"luck":{"type":"string","enum":["good","bad"]}},"required":["id","text","summary","stars","starText","sign","explanation","luck"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/emoji":{"get":{"operationId":"emoji","summary":"Emoji 合成","description":"指定两颗 Emoji 查询组合，均不提供时从全部有向组合中均匀随机抽取；优先精确顺序，未命中再查反向。","parameters":[{"name":"left","in":"query","required":false,"description":"支持实际 Emoji、u1f600 或 u1f62e-u200d-u1f4a8；保留完整序列。","schema":{"type":"string","maxLength":96,"default":""},"example":"u1f431"},{"name":"right","in":"query","required":false,"description":"支持实际 Emoji、u1f600 或 u1f62e-u200d-u1f4a8；保留完整序列。","schema":{"type":"string","maxLength":96,"default":""},"example":"u1f353"},{"name":"format","in":"query","required":false,"description":"JSON 或 307 图片跳转；错误始终返回 JSON。","schema":{"type":"string","enum":["json","image"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"left":{"type":"string"},"right":{"type":"string"},"date":{"type":"string"}},"required":["url","attribution","left","right","date"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"307":{"description":"图片 URL 跳转；不代理图片字节。","headers":{"Location":{"schema":{"type":"string","format":"uri"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/dynamic-emoji":{"get":{"operationId":"dynamic-emoji","summary":"动态 Emoji","description":"从版本化本地内容查询，无需账户。","parameters":[{"name":"emoji","in":"query","required":true,"description":"支持实际 Emoji、u1f600 或 u1f62e-u200d-u1f4a8；保留完整序列。","schema":{"type":"string","maxLength":96},"example":"u1f600"},{"name":"format","in":"query","required":false,"description":"JSON 或 307 图片跳转；错误始终返回 JSON。","schema":{"type":"string","enum":["json","image"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"id":{"type":"string"},"emoji":{"type":"string"},"name":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"licenseUrl":{"type":"string","format":"uri"},"sourceUrl":{"type":"string","format":"uri"}},"required":["url","attribution","id","emoji","name","license","licenseUrl","sourceUrl"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"307":{"description":"图片 URL 跳转；不代理图片字节。","headers":{"Location":{"schema":{"type":"string","format":"uri"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/kamen-riders":{"get":{"operationId":"kamen-riders","summary":"假面骑士索引","description":"本地系列与图片索引。url 是图片直链，用于展示与打开原图；sourcePage 是出处文件页。mediaStatus=unverified 表示服务端未验证外链可用性。","parameters":[{"name":"rider","in":"query","required":false,"description":"留空返回系列目录；使用目录里的 id，例如 kuuga。","schema":{"type":"string","maxLength":40,"default":""},"example":"kuuga"},{"name":"random","in":"query","required":false,"description":"true 时从选定系列或全库均匀抽取图片索引；不保证外部图片可访问。","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","required":false,"description":"从 1 开始的页码，超出数据页返回空列表。","schema":{"type":"integer","minimum":1,"maximum":1000000,"default":1}},{"name":"pageSize","in":"query","required":false,"description":"每页最多 100 条。","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"order":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","name","order","count"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","exclusiveMinimum":0,"maximum":100},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["page","pageSize","total","totalPages"],"additionalProperties":false}},"required":["items","pagination"],"additionalProperties":false},{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"sourcePage":{"type":"string","format":"uri"},"mediaStatus":{"type":"string","const":"unverified"}},"required":["id","name","url","sourcePage","mediaStatus"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","exclusiveMinimum":0,"maximum":100},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["page","pageSize","total","totalPages"],"additionalProperties":false},"rider":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"order":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","name","order","count"],"additionalProperties":false}},"required":["items","pagination","rider"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"sourcePage":{"type":"string","format":"uri"},"mediaStatus":{"type":"string","const":"unverified"},"rider":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"order":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","name","order","count"],"additionalProperties":false}},"required":["id","name","url","sourcePage","mediaStatus","rider"],"additionalProperties":false}]},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/iching/hexagrams/{number}":{"get":{"operationId":"iching-detail","summary":"按卦序研读经典","description":"1–64 文王卦序；卦辞、六爻、彖象与固定修订出处。乾用九、坤用六单独列于 extras。","parameters":[{"name":"number","in":"path","required":true,"description":"文王卦序，1–64。","schema":{"type":"integer","minimum":1,"maximum":64},"example":1}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"number":{"type":"integer","minimum":1,"maximum":64},"name":{"type":"string","minLength":1},"symbol":{"type":"string","minLength":1,"maxLength":1},"linesBottomUp":{"type":"array","prefixItems":[{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]}],"items":false,"minItems":6,"maxItems":6},"lowerTrigram":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]},"upperTrigram":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]},"judgment":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"tuan":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"image":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"lines":{"minItems":6,"maxItems":6,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"label":{"type":"string","minLength":1},"text":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"smallImage":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false}},"required":["position","label","text","smallImage"],"additionalProperties":false}},"extras":{"maxItems":1,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","enum":["用九","用六"]},"text":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"smallImage":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false}},"required":["label","text","smallImage"],"additionalProperties":false}},"provenance":{"type":"object","properties":{"baseEdition":{"type":"string","minLength":1},"attribution":{"type":"string","minLength":1},"revisionId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"revisionUrl":{"type":"string","format":"uri"},"pageUrl":{"type":"string","format":"uri"},"license":{"type":"string","const":"CC BY-SA 4.0"},"licenseUrl":{"type":"string","format":"uri"},"checkedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reviewStatus":{"type":"string","const":"source-verified"},"reviewMethod":{"type":"string","minLength":1}},"required":["baseEdition","attribution","revisionId","revisionUrl","pageUrl","license","licenseUrl","checkedAt","reviewStatus","reviewMethod"],"additionalProperties":false}},"required":["number","name","symbol","linesBottomUp","lowerTrigram","upperTrigram","judgment","tuan","image","lines","extras","provenance"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/iching/hexagrams/{number}/lines/{position}":{"get":{"operationId":"iching-line","summary":"按爻位读取爻辞","description":"position 从下向上为 1–6，返回爻辞、小象与底本出处。用九、用六不作为第七爻。","parameters":[{"name":"number","in":"path","required":true,"description":"文王卦序，1–64。","schema":{"type":"integer","minimum":1,"maximum":64},"example":1},{"name":"position","in":"path","required":true,"description":"自下向上的爻位，1–6。","schema":{"type":"integer","minimum":1,"maximum":6},"example":1}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"hexagram":{"type":"object","properties":{"number":{"type":"integer","minimum":1,"maximum":64},"name":{"type":"string","minLength":1},"symbol":{"type":"string","minLength":1,"maxLength":1},"linesBottomUp":{"type":"array","prefixItems":[{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]}],"items":false,"minItems":6,"maxItems":6},"lowerTrigram":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]},"upperTrigram":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]}},"required":["number","name","symbol","linesBottomUp","lowerTrigram","upperTrigram"],"additionalProperties":false},"line":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"label":{"type":"string","minLength":1},"text":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"smallImage":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false}},"required":["position","label","text","smallImage"],"additionalProperties":false},"provenance":{"type":"object","properties":{"baseEdition":{"type":"string","minLength":1},"attribution":{"type":"string","minLength":1},"revisionId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"revisionUrl":{"type":"string","format":"uri"},"pageUrl":{"type":"string","format":"uri"},"license":{"type":"string","const":"CC BY-SA 4.0"},"licenseUrl":{"type":"string","format":"uri"},"checkedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reviewStatus":{"type":"string","const":"source-verified"},"reviewMethod":{"type":"string","minLength":1}},"required":["baseEdition","attribution","revisionId","revisionUrl","pageUrl","license","licenseUrl","checkedAt","reviewStatus","reviewMethod"],"additionalProperties":false}},"required":["hexagram","line","provenance"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/iching/trigrams":{"get":{"operationId":"iching-trigrams","summary":"八卦结构","description":"八卦名称、卦符、物象与自下而上的三爻结构。","parameters":[],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"minItems":8,"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]},"name":{"type":"string","minLength":1},"symbol":{"type":"string","minLength":1,"maxLength":1},"image":{"type":"string","minLength":1},"linesBottomUp":{"type":"array","prefixItems":[{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]}],"items":false,"minItems":3,"maxItems":3}},"required":["id","name","symbol","image","linesBottomUp"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/iching/random":{"get":{"operationId":"iching-random","summary":"随机学习一卦","description":"从 64 卦中均匀随机抽取一卦供经典研读，不作预测；响应不缓存。","parameters":[],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"number":{"type":"integer","minimum":1,"maximum":64},"name":{"type":"string","minLength":1},"symbol":{"type":"string","minLength":1,"maxLength":1},"linesBottomUp":{"type":"array","prefixItems":[{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]}],"items":false,"minItems":6,"maxItems":6},"lowerTrigram":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]},"upperTrigram":{"type":"string","enum":["qian","dui","li","zhen","xun","kan","gen","kun"]},"judgment":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"tuan":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"image":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"lines":{"minItems":6,"maxItems":6,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"label":{"type":"string","minLength":1},"text":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"smallImage":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false}},"required":["position","label","text","smallImage"],"additionalProperties":false}},"extras":{"maxItems":1,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","enum":["用九","用六"]},"text":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false},"smallImage":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"notes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["text","source","url","notes"],"additionalProperties":false}},"required":["label","text","smallImage"],"additionalProperties":false}},"provenance":{"type":"object","properties":{"baseEdition":{"type":"string","minLength":1},"attribution":{"type":"string","minLength":1},"revisionId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"revisionUrl":{"type":"string","format":"uri"},"pageUrl":{"type":"string","format":"uri"},"license":{"type":"string","const":"CC BY-SA 4.0"},"licenseUrl":{"type":"string","format":"uri"},"checkedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reviewStatus":{"type":"string","const":"source-verified"},"reviewMethod":{"type":"string","minLength":1}},"required":["baseEdition","attribution","revisionId","revisionUrl","pageUrl","license","licenseUrl","checkedAt","reviewStatus","reviewMethod"],"additionalProperties":false}},"required":["number","name","symbol","linesBottomUp","lowerTrigram","upperTrigram","judgment","tuan","image","lines","extras","provenance"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/answerbook/pages/{page}":{"get":{"operationId":"answerbook-page","summary":"答案之书固定页","description":"按构建数据的稳定顺序读取答案，页码从 1 开始；同一 dataVersion 内页码与内容固定。非法页码返回 400，超出总页数返回 404。仅返回 JSON。","parameters":[{"name":"page","in":"path","required":true,"description":"固定答案页码；总页数见响应 totalPages，同一数据版本内对应内容不变。","schema":{"type":"integer","minimum":1,"maximum":263},"example":1}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1},"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"totalPages":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","text","page","totalPages"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/hitokoto/all":{"get":{"operationId":"hitokoto-list","summary":"一言分页","description":"按原始数字 ID 升序；最多 100 条/页。","parameters":[{"name":"category","in":"query","required":false,"description":"all 为全部；a 动画 / b 漫画 / c 游戏 / d 文学 / e 原创 / f 网络 / g 其他 / h 影视 / i 诗词 / j 网易云 / k 哲学 / l 抖机灵。","schema":{"type":"string","enum":["all","a","b","c","d","e","f","g","h","i","j","k","l"],"default":"all"}},{"name":"page","in":"query","required":false,"description":"从 1 开始的页码，超出数据页返回空列表。","schema":{"type":"integer","minimum":1,"maximum":1000000,"default":1}},{"name":"pageSize","in":"query","required":false,"description":"每页最多 100 条。","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"uuid":{"type":"string"},"text":{"type":"string","minLength":1},"category":{"type":"string","enum":["a","b","c","d","e","f","g","h","i","j","k","l"]},"source":{"type":["string","null"]},"author":{"type":["string","null"]}},"required":["id","uuid","text","category","source","author"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","exclusiveMinimum":0,"maximum":100},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["page","pageSize","total","totalPages"],"additionalProperties":false}},"required":["items","pagination"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/hitokoto/{id}":{"get":{"operationId":"hitokoto-by-id","summary":"按原始 ID 查询一言","description":"保留原库 ID，ID 不连续。","parameters":[{"name":"id","in":"path","required":true,"description":"原库数字 ID","schema":{"type":"integer","minimum":1}},{"name":"format","in":"query","required":false,"description":"JSON 或纯文本；错误始终返回 JSON。","schema":{"type":"string","enum":["json","txt"],"default":"json"}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"uuid":{"type":"string"},"text":{"type":"string","minLength":1},"category":{"type":"string","enum":["a","b","c","d","e","f","g","h","i","j","k","l"]},"source":{"type":["string","null"]},"author":{"type":["string","null"]}},"required":["id","uuid","text","category","source","author"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/emoji/catalog":{"get":{"operationId":"emoji-catalog","summary":"可合成 Emoji 目录","description":"可分页搜索；并非任意两颗都存在组合。","parameters":[{"name":"q","in":"query","required":false,"description":"按名称、Emoji 或编码搜索。","schema":{"type":"string","maxLength":80,"default":""}},{"name":"page","in":"query","required":false,"description":"从 1 开始的页码，超出数据页返回空列表。","schema":{"type":"integer","minimum":1,"maximum":1000000,"default":1}},{"name":"pageSize","in":"query","required":false,"description":"每页最多 100 条。","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"emoji":{"type":"string"},"name":{"type":"string"}},"required":["id","emoji","name"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","exclusiveMinimum":0,"maximum":100},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["page","pageSize","total","totalPages"],"additionalProperties":false}},"required":["items","pagination"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/dynamic-emoji/catalog":{"get":{"operationId":"dynamic-catalog","summary":"动态 Emoji 目录","description":"Google 官方动画索引快照，保留完整 Unicode 序列。","parameters":[{"name":"q","in":"query","required":false,"description":"按名称、Emoji 或编码搜索。","schema":{"type":"string","maxLength":80,"default":""}},{"name":"page","in":"query","required":false,"description":"从 1 开始的页码，超出数据页返回空列表。","schema":{"type":"integer","minimum":1,"maximum":1000000,"default":1}},{"name":"pageSize","in":"query","required":false,"description":"每页最多 100 条。","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"emoji":{"type":"string"},"name":{"type":"string"}},"required":["id","emoji","name"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","exclusiveMinimum":0,"maximum":100},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["page","pageSize","total","totalPages"],"additionalProperties":false}},"required":["items","pagination"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/catalog":{"get":{"operationId":"catalog","summary":"接口目录","description":"公开的参数、说明与数据版本。","parameters":[],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"endpoints":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"path":{"type":"string"},"summary":{"type":"string"},"description":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"type":{"type":"string","enum":["string","enum","integer","boolean"]},"default":{"type":"string"},"example":{"type":"string"},"required":{"type":"boolean"},"options":{"type":"array","items":{"type":"string"}},"minimum":{"type":"number"},"maximum":{"type":"number"},"maxLength":{"type":"number"}},"required":["name","label","description","type"],"additionalProperties":false}},"response":{"type":"string"},"media":{"type":"string","enum":["text","image"]}},"required":["id","path","summary","description","parameters","response"],"additionalProperties":false}},"counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["endpoints","counts"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/health":{"get":{"operationId":"health","summary":"健康检查","description":"报告本地数据版本，不探测第三方图片。","parameters":[],"responses":{"200":{"description":"查询成功","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","const":"ok"},"database":{"type":"boolean","const":false},"mediaProbe":{"type":"boolean","const":false}},"required":["status","database","mediaProbe"],"additionalProperties":false},"meta":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"dataVersion":{"type":"string"}},"required":["apiVersion","dataVersion"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"参数错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"未收录或没有对应组合","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"方法不支持","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"查询过长","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"服务异常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}}},"required":["code","message"],"additionalProperties":false},"requestId":{"type":"string"}},"required":["error","requestId"],"additionalProperties":false}}}}