{"openapi":"3.1.0","info":{"title":"见贤历史材料 API","version":"1.0.0","description":"仅返回自主整理的历史材料；不进行生成式推理，不返回来源、书目、摘录、链接或私人对话。分数为排序相关度，不是建议正确的概率。"},"servers":[{"url":"https://thegreats.cn"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Episode":{"type":"object","additionalProperties":false,"properties":{"episode_id":{"type":"string"},"version":{"type":"integer"},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"original_name":{"type":"string"}}},"episode":{"type":"object","properties":{"title":{"type":["string","null"]},"core_theme":{"type":["string","null"]},"summary":{"type":["string","null"]},"problem":{"type":["string","null"]},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["string","null"]},"reasoning":{"type":["string","null"]}}}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["string","null"]},"related_decision_ids":{"type":"array","items":{"type":"string"}}}}},"tags":{"type":"array","items":{"type":"string"}}}}},"required":["episode_id","version","person","episode"]}}},"paths":{"/api/v1/episodes/search":{"post":{"operationId":"searchEpisodes","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":128},"description":"重试同一请求时保持相同值；不同请求不能复用。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","minLength":2,"maxLength":2000},"limit":{"type":"integer","minimum":1,"maximum":5,"default":5},"person_id":{"type":"string","maxLength":160}},"required":["query"]}}}},"responses":{"200":{"description":"已收录的历史材料","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","maxItems":5,"items":{"type":"object","additionalProperties":false,"properties":{"episode_id":{"type":"string"},"version":{"type":"integer"},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"original_name":{"type":"string"}}},"episode":{"type":"object","properties":{"title":{"type":["string","null"]},"core_theme":{"type":["string","null"]},"summary":{"type":["string","null"]},"problem":{"type":["string","null"]},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["string","null"]},"reasoning":{"type":["string","null"]}}}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["string","null"]},"related_decision_ids":{"type":"array","items":{"type":"string"}}}}},"tags":{"type":"array","items":{"type":"string"}}}},"similarity_score":{"type":"number"},"score_type":{"type":"string","enum":["rerank","rrf"]}},"required":["episode_id","version","person","episode","similarity_score","score_type"]}},"has_more":{"type":"boolean"},"rerank_status":{"type":"string"}}}}}},"400":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"401":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"403":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"404":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"409":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"429":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"503":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}}}}},"/api/v1/episodes/{id}":{"get":{"operationId":"getEpisode","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":128},"description":"重试同一请求时保持相同值；不同请求不能复用。"}],"responses":{"200":{"description":"已收录的历史材料","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Episode"}}}},"400":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"401":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"403":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"404":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"409":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"429":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"503":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}}}}},"/api/v1/people/{id}":{"get":{"operationId":"getPerson","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":128},"description":"重试同一请求时保持相同值；不同请求不能复用。"},{"name":"cursor","in":"query","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}}],"responses":{"200":{"description":"已收录的历史材料","content":{"application/json":{"schema":{"type":"object","properties":{"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"original_name":{"type":"string"},"birth_date":{"type":["string","null"]},"death_date":{"type":["string","null"]},"description":{"type":["string","null"]}}},"items":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"episode_id":{"type":"string"},"title":{"type":["string","null"]},"core_theme":{"type":["string","null"]},"version":{"type":"integer"}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}}}}}},"400":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"401":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"403":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"404":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"409":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"429":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}},"503":{"description":"稳定错误码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"]}},"required":["error"]}}}}}}}}}