{"openapi":"3.1.0","info":{"title":"다운 규약 문서 API","version":"0.1.0","description":"다운(Dawoon) 개발·상품 제작·업무 규약 문서를 읽는 API입니다. 키 없이 호출하면 공개(public) 문서만, 발급받은 키를 `Authorization: Bearer dwd_...` 또는 `X-API-Key` 헤더로 보내면 등급(partner·internal)에 맞는 문서가 보입니다."},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"dwd_ 로 시작하는 접근 키"},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{}},"paths":{"/healthz":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/api/v1/whoami":{"get":{"summary":"내 접근 등급 확인","tags":["계정"],"description":"키 없이 호출하면 public. 키가 있으면 이름과 등급을 돌려준다.","security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"level":{"type":"string","enum":["public","partner","internal"]},"levelLabel":{"type":"string"},"keyName":{"type":["null","string"]},"keyPrefix":{"type":["null","string"]}}}}}}}}},"/api/v1/categories":{"get":{"summary":"분류 목록과 볼 수 있는 문서 수","tags":["문서"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"count":{"type":"number"}}}}}}}}}},"/api/v1/docs":{"get":{"summary":"문서 목록 (본문 제외)","tags":["문서"],"parameters":[{"schema":{"type":"string","enum":["guide","dev","product","work"]},"in":"query","name":"category","required":false},{"schema":{"type":"string"},"in":"query","name":"tag","required":false},{"schema":{"type":"string","enum":["default","title","updated","version","category"],"default":"default"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"in":"query","name":"order","required":false}],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"dev/commit-message"},"category":{"type":"string","enum":["guide","dev","product","work"]},"slug":{"type":"string"},"title":{"type":"string"},"visibility":{"type":"string","enum":["public","partner","internal"]},"version":{"type":"string","example":"1.0.0"},"updated":{"type":"string","format":"date"},"owner":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"order":{"type":"number"}}}}}}}}}},"/api/v1/docs/{category}/{slug}":{"get":{"summary":"문서 한 편","tags":["문서"],"description":"format=markdown 이면 원본 마크다운(text/markdown)만, 기본(json)은 메타 + markdown + html.","parameters":[{"schema":{"type":"string","enum":["json","markdown"],"default":"json"},"in":"query","name":"format","required":false},{"schema":{"type":"string"},"in":"path","name":"category","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"dev/commit-message"},"category":{"type":"string","enum":["guide","dev","product","work"]},"slug":{"type":"string"},"title":{"type":"string"},"visibility":{"type":"string","enum":["public","partner","internal"]},"version":{"type":"string","example":"1.0.0"},"updated":{"type":"string","format":"date"},"owner":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"order":{"type":"number"},"markdown":{"type":"string"},"html":{"type":"string"},"headings":{"type":"array","items":{"type":"object","properties":{"depth":{"type":"number"},"text":{"type":"string"},"anchor":{"type":"string"}}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/search":{"get":{"summary":"문서 검색","tags":["문서"],"description":"공백으로 나눈 모든 단어를 포함한 문서를 제목·태그·요약 가중치로 정렬한다.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"q","required":true},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"in":"query","name":"limit","required":false}],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"dev/commit-message"},"category":{"type":"string","enum":["guide","dev","product","work"]},"slug":{"type":"string"},"title":{"type":"string"},"visibility":{"type":"string","enum":["public","partner","internal"]},"version":{"type":"string","example":"1.0.0"},"updated":{"type":"string","format":"date"},"owner":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"order":{"type":"number"},"score":{"type":"number"},"snippet":{"type":"string"}}}}}}}}}},"/mcp":{"post":{"responses":{"200":{"description":"Default Response"}}},"get":{"responses":{"200":{"description":"Default Response"}}},"delete":{"responses":{"200":{"description":"Default Response"}}}},"/":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/docs":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/docs/{category}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"category","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/docs/{category}/{slug}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"category","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/search":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/login":{"get":{"responses":{"200":{"description":"Default Response"}}},"post":{"responses":{"200":{"description":"Default Response"}}}},"/logout":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/llms.txt":{"get":{"responses":{"200":{"description":"Default Response"}}}}},"servers":[{"url":"https://docs.dawoon.link"}],"tags":[{"name":"문서","description":"규약 문서 조회"},{"name":"계정","description":"접근 등급"}]}