{"openapi":"3.1.0","info":{"title":"嘎嘎文献库 · 文献与解读 API","version":"1.1.0","description":"Read-only bibliography and abstracts in lists; existing full public analyses in single-paper details. No PDF files, raw full text, private user data, source paths or document download URLs. Excluded records and uploads are omitted. Missing content is not generated on request; deep-reading coverage is preserved."},"servers":[{"url":"/"}],"security":[],"paths":{"/api/v1":{"get":{"summary":"API configuration","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid Bearer key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited; retry after Retry-After seconds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/health":{"get":{"summary":"Health","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid Bearer key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited; retry after Retry-After seconds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/openapi.json":{"get":{"summary":"OpenAPI document","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid Bearer key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited; retry after Retry-After seconds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/papers":{"get":{"summary":"Search bibliography and abstracts (id ascending)","parameters":[{"name":"q","in":"query","description":"Literal title, author or DOI substring, up to 200 characters","schema":{"type":"string","maxLength":200}},{"name":"doi","in":"query","description":"Exact DOI; https://doi.org/ prefix is accepted","schema":{"type":"string","maxLength":512}},{"name":"journal","in":"query","description":"Journal code or full name","schema":{"type":"string","maxLength":200}},{"name":"year","in":"query","description":"Four-digit publication year","schema":{"type":"integer","minimum":1000,"maximum":9999}},{"name":"limit","in":"query","description":"Page size: 1–100, default 20","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","description":"Last returned id; keep other filters unchanged","schema":{"type":"integer","minimum":0,"maximum":9223372036854775807}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Paper"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_cursor":{"type":["integer","null"]}}}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid Bearer key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited; retry after Retry-After seconds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/papers/{id}":{"get":{"summary":"Single paper with abstracts and all existing public analyses","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"item":{"$ref":"#/components/schemas/PaperDetail"}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid Bearer key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited; retry after Retry-After seconds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"PublicContentSource":{"type":"object","additionalProperties":false,"properties":{"pages":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"uniqueItems":true},"paragraphs":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"uniqueItems":true},"lines":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"uniqueItems":true},"document_id":{"type":"string"},"label":{"type":"string"}},"required":["label"],"oneOf":[{"required":["pages"]},{"required":["paragraphs"]},{"required":["lines"]}]},"PublicContentDocument":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"label_zh":{"type":"string"},"snapshot_note_zh":{"type":"string"},"format":{"type":"string","enum":["pdf","docx","web","code"]},"page_count":{"type":"integer","minimum":1},"pages_reviewed":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"uniqueItems":true},"paragraph_count":{"type":"integer","minimum":1},"paragraphs_reviewed":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"uniqueItems":true},"line_count":{"type":"integer","minimum":1},"lines_reviewed":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"uniqueItems":true}},"required":["id","label_zh","format"],"oneOf":[{"properties":{"format":{"const":"pdf"}},"required":["page_count","pages_reviewed"]},{"properties":{"format":{"const":"docx"}},"required":["paragraph_count","paragraphs_reviewed"]},{"properties":{"format":{"const":"web"}},"required":["paragraph_count","paragraphs_reviewed","snapshot_note_zh"]},{"properties":{"format":{"const":"code"}},"required":["line_count","lines_reviewed","snapshot_note_zh"]}]},"PublicContentCoverage":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["complete","partial"]},"note_zh":{"type":"string"},"source_version":{"type":"string"},"pages_reviewed":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"uniqueItems":true},"missing_items_zh":{"type":"array","items":{"type":"string"}}},"required":["status","note_zh","source_version","pages_reviewed","missing_items_zh"]},"PublicContentTheory":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name_zh":{"type":"string"},"origin_zh":{"type":"string"},"explanation_zh":{"type":"string"},"role_zh":{"type":"string"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentSource"},"minItems":1}},"required":["id","name_zh","origin_zh","explanation_zh","role_zh","sources"]},"PublicContentHypothesis":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string","enum":["hypothesis","proposition"]},"statement_zh":{"type":"string"},"derivation_zh":{"type":"string"},"mechanism_zh":{"type":"string"},"boundary_zh":{"type":"string"},"result_zh":{"type":"string"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentSource"},"minItems":1},"theory_ids":{"type":"array","items":{"type":"string"}},"study_ids":{"type":"array","items":{"type":"string"}}},"required":["id","label","kind","statement_zh","derivation_zh","mechanism_zh","boundary_zh","result_zh","sources","theory_ids","study_ids"]},"PublicContentStudy":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string"},"question_zh":{"type":"string"},"design_zh":{"type":"string"},"sample_zh":{"type":"string"},"procedure_zh":{"type":"string"},"measures_zh":{"type":"string"},"analysis_zh":{"type":"string"},"results_zh":{"type":"string"},"interpretation_zh":{"type":"string"},"limitations_zh":{"type":"string"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentSource"},"minItems":1},"hypothesis_ids":{"type":"array","items":{"type":"string"}}},"required":["id","label","kind","question_zh","design_zh","sample_zh","procedure_zh","measures_zh","analysis_zh","results_zh","interpretation_zh","limitations_zh","sources","hypothesis_ids"]},"PublicContentArgument":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"label":{"type":"string"},"claim_zh":{"type":"string"},"reasoning_zh":{"type":"string"},"implication_zh":{"type":"string"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentSource"},"minItems":1}},"required":["id","label","claim_zh","reasoning_zh","implication_zh","sources"]},"PublicContentEvidence":{"type":"object","additionalProperties":false,"properties":{"claim_zh":{"type":"string"},"evidence_zh":{"type":"string"},"boundary_zh":{"type":"string"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentSource"},"minItems":1},"study_ids":{"type":"array","items":{"type":"string"}}},"required":["claim_zh","evidence_zh","boundary_zh","sources","study_ids"]},"PublicDeepAnalysis":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"integer","const":1},"article_kind":{"type":"string","enum":["editorial","empirical","methodological","other","qualitative","review","theoretical"]},"overview_zh":{"type":"string"},"conclusion_zh":{"type":"string"},"limitations_zh":{"type":"string"},"coverage":{"$ref":"#/components/schemas/PublicContentCoverage"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentDocument"}},"theories":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentTheory"}},"hypotheses":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentHypothesis"}},"studies":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentStudy"}},"arguments":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentArgument"}},"evidence_map":{"type":"array","items":{"$ref":"#/components/schemas/PublicContentEvidence"}}},"required":["schema_version","article_kind","overview_zh","conclusion_zh","limitations_zh","coverage","documents","theories","hypotheses","studies","arguments","evidence_map"]},"PublicContentAvailability":{"type":"object","additionalProperties":false,"properties":{"abstract_en":{"type":"boolean"},"abstract_zh":{"type":"boolean"},"legacy_analysis":{"type":"boolean"},"deep_analysis":{"type":"boolean"},"deep_coverage":{"type":["string","null"],"enum":["complete","partial",null]}},"required":["abstract_en","abstract_zh","legacy_analysis","deep_analysis","deep_coverage"]},"PublicLegacyConcepts":{"type":"object","additionalProperties":false,"properties":{"term_zh":{"type":"string"},"term_en":{"type":"string"},"explanation_zh":{"type":"string"},"term":{"type":"string"},"definition":{"type":"string"}},"required":[]},"PublicLegacyReadingNotes":{"type":"object","additionalProperties":false,"properties":{"heading":{"type":"string"},"body":{"type":"string"},"title":{"type":"string"},"content":{"type":"string"}},"required":[]},"PublicLegacyStudyDetails":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"design":{"type":"string"},"sample":{"type":"string"},"paradigm":{"type":"string"},"note":{"type":"string"},"heading":{"type":"string"},"body":{"type":"string"}},"required":[]},"Paper":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"integer"},"title":{"type":["string","null"]},"title_zh":{"type":["string","null"]},"authors":{"type":["string","null"]},"journal_code":{"type":["string","null"]},"journal_name":{"type":["string","null"]},"year":{"type":["integer","null"]},"month":{"type":["string","integer","null"]},"volume":{"type":["string","integer","null"]},"issue":{"type":["string","integer","null"]},"page_start":{"type":["string","null"]},"doi":{"type":["string","null"]},"doi_url":{"type":["string","null"]},"article_type":{"type":["string","null"]},"updated_at":{"type":["string","null"]},"abstract_en":{"type":["string","null"]},"abstract_zh":{"type":["string","null"]}},"required":["id","title","title_zh","authors","journal_code","journal_name","year","month","volume","issue","page_start","doi","doi_url","article_type","updated_at","abstract_en","abstract_zh"]},"PaperDetail":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"integer"},"title":{"type":["string","null"]},"title_zh":{"type":["string","null"]},"authors":{"type":["string","null"]},"journal_code":{"type":["string","null"]},"journal_name":{"type":["string","null"]},"year":{"type":["integer","null"]},"month":{"type":["string","integer","null"]},"volume":{"type":["string","integer","null"]},"issue":{"type":["string","integer","null"]},"page_start":{"type":["string","null"]},"doi":{"type":["string","null"]},"doi_url":{"type":["string","null"]},"article_type":{"type":["string","null"]},"updated_at":{"type":["string","null"]},"abstract_en":{"type":["string","null"]},"abstract_zh":{"type":["string","null"]},"article_type_label_zh":{"type":"string"},"feed_summary_zh":{"type":"string"},"core_question_zh":{"type":"string"},"model_zh":{"type":"string"},"problem_solution_zh":{"type":"string"},"summary_zh":{"type":"string"},"methods_zh":{"type":"string"},"study_count_zh":{"type":"string"},"special_paradigms_zh":{"type":"string"},"keywords_zh":{"type":"array","items":{"type":"string"}},"highlights_zh":{"type":"array","items":{"type":"string"}},"concepts":{"type":"array","items":{"$ref":"#/components/schemas/PublicLegacyConcepts"}},"reading_notes":{"type":"array","items":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/PublicLegacyReadingNotes"}]}},"study_details":{"type":"array","items":{"$ref":"#/components/schemas/PublicLegacyStudyDetails"}},"deep_analysis":{"oneOf":[{"$ref":"#/components/schemas/PublicDeepAnalysis"},{"type":"null"}]},"content_availability":{"$ref":"#/components/schemas/PublicContentAvailability"}},"required":["id","title","title_zh","authors","journal_code","journal_name","year","month","volume","issue","page_start","doi","doi_url","article_type","updated_at","abstract_en","abstract_zh","article_type_label_zh","feed_summary_zh","core_question_zh","model_zh","problem_solution_zh","summary_zh","methods_zh","study_count_zh","special_paradigms_zh","keywords_zh","highlights_zh","concepts","reading_notes","study_details","deep_analysis","content_availability"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}}