{"openapi":"3.1.0","info":{"title":"한의학 아틀라스 Public Read API","version":"0.1.0","description":"한국어 한의학 고전 지식의 항목 검색, 공개 문서, 1단계 관계 탐색 API입니다. 전통 문헌 기록을 현대적 진단이나 복용 지침으로 해석하지 않습니다.","termsOfService":"https://atlas.baekrokdam.com/ai.txt","contact":{"name":"백록담한의원","url":"https://www.baekrokdam.com/"}},"servers":[{"url":"https://atlas.baekrokdam.com"}],"externalDocs":{"description":"에이전트 사용 안내","url":"https://atlas.baekrokdam.com/agents"},"paths":{"/api/v1/changes":{"get":{"operationId":"listAtlasChanges","summary":"본문 재작성 전을 포함한 공개 그래프·엔티티·근거 변화 조회","parameters":[{"name":"since","in":"query","required":false,"description":"ISO-8601 시작 시각","schema":{"type":"string","format":"date-time"}},{"name":"limit","in":"query","required":false,"description":"반환 개수, 최대 100","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"공개 변경 신호와 현재 본문 투영 상태"}}}},"/api/v1/search":{"get":{"operationId":"searchAtlas","summary":"한글·한자 이름과 본문에서 항목 검색","parameters":[{"name":"q","in":"query","required":true,"description":"검색어","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"반환 개수, 최대 80","schema":{"type":"integer","minimum":1,"maximum":80,"default":30}}],"responses":{"200":{"description":"검색 결과"}}}},"/api/v1/pages/ko/{slug}":{"get":{"operationId":"getKoreanAtlasPage","summary":"정규 항목의 본문·출처와 읽기용 관계 투영 조회","description":"원문 기록, 처방 구성, 출처와 최대 120개의 공개 문서 관계를 반환하며 relationSummary에 전체 수와 그래프 조회 경로를 제공합니다.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"공개 항목과 안정적인 크기의 관계 투영"},"404":{"description":"항목 없음"}}}},"/api/v1/graph":{"get":{"operationId":"queryAtlasNeighbors","summary":"정규 항목에서 이어지는 공개 관계와 근거 조회","parameters":[{"name":"slug","in":"query","required":true,"description":"시작 항목 slug","schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"description":"both, incoming, outgoing","schema":{"type":"string","enum":["both","incoming","outgoing"],"default":"both"}},{"name":"world","in":"query","required":false,"description":"쉼표로 구분한 결과 유형","schema":{"type":"string"}},{"name":"predicate","in":"query","required":false,"description":"관계 술어","schema":{"type":"string"}},{"name":"work","in":"query","required":false,"description":"출전 의서의 정규 slug. 근거에 해당 의서 ID가 연결된 관계만 반환","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"반환 관계 수, 최대 100","schema":{"type":"integer","minimum":1,"maximum":100,"default":24}},{"name":"offset","in":"query","required":false,"description":"다음 관계 묶음의 시작 위치","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"시작 노드, 이웃 노드, claimId·공개 근거를 포함한 관계 및 다음 offset"},"400":{"description":"잘못된 페이지 범위"},"404":{"description":"시작 항목 또는 출전 의서 없음"}}}}},"x-atlas-access":{"tier":"public-beta","readOnly":true,"intendedUse":"small sequential lookups","bulkAccess":"future project API key","guide":"https://atlas.baekrokdam.com/agent-guide.md"}}