{"openapi":"3.1.0","info":{"title":"코아(COA · CORE OF ALCHEMY) 공개 API","version":"0.2.0","description":"국내 제조 레더 슈즈 브랜드 코아(COA · CORE OF ALCHEMY)의 자사몰. 3중 쿠션 인솔 · 양가죽·송아지가죽 · 더비/로퍼/부츠/스니커즈/플랫. 로그인·열쇠 없이 읽기만. 값은 자사몰 표시값 · 사이즈별 재고는 상품 하나 쪽(카페24 재고, 60초 안 값). 광고·가산 없음. 엠시피 https://coa.shoes/mcp · 안내 https://coa.shoes/llms.txt"},"servers":[{"url":"https://coa.shoes"}],"paths":{"/api/ai/products":{"get":{"operationId":"searchProducts","summary":"상품 찾기·전체 목록(JSON)","description":"q 없으면 전체(limit 까지). 점수 = 이름 5 · 종류 4 · 라인 3 · 소재 2 · 소개 1, 같은 점수면 싼 순.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"찾는 말"},{"name":"line","in":"query","required":false,"schema":{"type":"string","enum":["coa","tracker","origin","black-noir","ove","core-of-standard"]},"description":"라인(갈래)"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["더비","부츠","메리제인","스니커즈","로퍼","플랫","슬리퍼","기타"]},"description":"신발 종류"},{"name":"size","in":"query","required":false,"schema":{"type":"string"},"description":"그 사이즈가 있는 상품만(예 250)"},{"name":"min","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"최저 값(원)"},{"name":"max","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"최고 값(원)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"몇 개까지(기본 20 · 최대 100)"}],"responses":{"200":{"description":"결과","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string"},"total":{"type":"integer"},"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"product_no":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"name_ko":{"type":"string"},"line":{"type":"string"},"line_ko":{"type":"string"},"line_slug":{"type":"string","enum":["coa","tracker","origin","black-noir","ove","core-of-standard"]},"kind":{"type":"string","enum":["더비","부츠","메리제인","스니커즈","로퍼","플랫","슬리퍼","기타"]},"price":{"type":"integer","description":"판매가(원)"},"retail_price":{"type":"integer","description":"정가(원)"},"has_discount":{"type":"boolean"},"currency":{"type":"string","enum":["KRW"]},"availability":{"type":"string","enum":["in_stock","out_of_stock","unknown"]},"page_url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"image_url":{"type":"string"},"image_urls":{"type":"array","items":{"type":"string"}},"summary":{"type":["string","null"]},"description":{"type":"string"},"materials":{"type":"object","properties":{"upper":{"type":["string","null"]},"lining":{"type":["string","null"]},"insole":{"type":["string","null"]},"outsole":{"type":["string","null"]}}},"height_cm":{"type":["number","null"],"description":"총 굽 높이(cm)"},"sizes":{"type":"array","items":{"type":"string"}},"size_tip":{"type":["string","null"]},"fit_note":{"type":["string","null"]},"wide":{"type":"boolean"},"light":{"type":"boolean"},"gender":{"type":["string","null"]},"occasions":{"type":"array","items":{"type":"string"}},"color":{"type":["string","null"],"description":"색 이름(예 \"블랙 (Black)\")"},"rain_ok":{"type":"boolean","description":"고무창이라 약한 비는 무리 없음"},"target_user":{"type":["string","null"],"description":"이런 분께(원문)"},"recommend":{"type":"object","description":"AI 가 그대로 말해도 되는 추천 근거(사실 칸만)","properties":{"for":{"type":"array","items":{"type":"string"}},"why":{"type":"array","items":{"type":"string"}},"caution":{"type":"array","items":{"type":"string"}}}},"musinsa_review_url":{"type":["string","null"],"format":"uri","description":"구매 후기는 무신사 상품 쪽에"}}}}}}}}}}}},"/api/ai/products/{slug}":{"get":{"operationId":"getProduct","summary":"상품 하나(JSON · 사이즈별 재고)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"상품 slug (예 coa-43)"}],"responses":{"200":{"description":"상품","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string"},"product":{"allOf":[{"type":"object","properties":{"slug":{"type":"string"},"product_no":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"name_ko":{"type":"string"},"line":{"type":"string"},"line_ko":{"type":"string"},"line_slug":{"type":"string","enum":["coa","tracker","origin","black-noir","ove","core-of-standard"]},"kind":{"type":"string","enum":["더비","부츠","메리제인","스니커즈","로퍼","플랫","슬리퍼","기타"]},"price":{"type":"integer","description":"판매가(원)"},"retail_price":{"type":"integer","description":"정가(원)"},"has_discount":{"type":"boolean"},"currency":{"type":"string","enum":["KRW"]},"availability":{"type":"string","enum":["in_stock","out_of_stock","unknown"]},"page_url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"image_url":{"type":"string"},"image_urls":{"type":"array","items":{"type":"string"}},"summary":{"type":["string","null"]},"description":{"type":"string"},"materials":{"type":"object","properties":{"upper":{"type":["string","null"]},"lining":{"type":["string","null"]},"insole":{"type":["string","null"]},"outsole":{"type":["string","null"]}}},"height_cm":{"type":["number","null"],"description":"총 굽 높이(cm)"},"sizes":{"type":"array","items":{"type":"string"}},"size_tip":{"type":["string","null"]},"fit_note":{"type":["string","null"]},"wide":{"type":"boolean"},"light":{"type":"boolean"},"gender":{"type":["string","null"]},"occasions":{"type":"array","items":{"type":"string"}},"color":{"type":["string","null"],"description":"색 이름(예 \"블랙 (Black)\")"},"rain_ok":{"type":"boolean","description":"고무창이라 약한 비는 무리 없음"},"target_user":{"type":["string","null"],"description":"이런 분께(원문)"},"recommend":{"type":"object","description":"AI 가 그대로 말해도 되는 추천 근거(사실 칸만)","properties":{"for":{"type":"array","items":{"type":"string"}},"why":{"type":"array","items":{"type":"string"}},"caution":{"type":"array","items":{"type":"string"}}}},"musinsa_review_url":{"type":["string","null"],"format":"uri","description":"구매 후기는 무신사 상품 쪽에"}}},{"type":"object","properties":{"sizes_in_stock":{"type":["array","null"],"items":{"type":"string"},"description":"지금 살 수 있는 사이즈(카페24 재고 · 조회 못 하면 null)"},"sizes_sold_out":{"type":["array","null"],"items":{"type":"string"}},"care":{"type":["string","null"]},"cs":{"type":["object","null"],"properties":{"fit":{"type":["string","null"]},"waterproof":{"type":["string","null"]},"size":{"type":["string","null"]},"care":{"type":["string","null"]},"office":{"type":["string","null"]}}}}}]}}}}}},"404":{"description":"없는 상품"}}}},"/api/ai/recommend":{"get":{"operationId":"recommendProducts","summary":"손님 조건으로 추천(JSON · 근거 포함)","description":"성별·상황·필요(키높이/발볼/가벼움/비)·종류·라인·사이즈·값으로 점수순 추천. 점수 = 성별 4 · 상황 4 · 필요 3(각) · 찾는 말 · 할인 1 · 품절 -5, 같은 점수면 싼 순. 상위 5개는 sizes_in_stock 포함. 조건이 하나는 있어야 함.","parameters":[{"name":"gender","in":"query","required":false,"schema":{"type":"string","enum":["male","female","unisex"]},"description":"손님 성별"},{"name":"occasion","in":"query","required":false,"schema":{"type":"string","maxLength":40},"description":"상황 — 주말 캐주얼 · 비즈니스 캐주얼 · 출근/비즈니스 캐주얼 · 오래 걷는 날 · 특별한 자리(비슷한 말도 됨)"},{"name":"needs","in":"query","required":false,"schema":{"type":"string","maxLength":60},"description":"필요 — 키높이, 발볼, 가벼움, 비 중 여러 개(쉼표)"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["더비","부츠","메리제인","스니커즈","로퍼","플랫","슬리퍼","기타"]},"description":"신발 종류"},{"name":"line","in":"query","required":false,"schema":{"type":"string","enum":["coa","tracker","origin","black-noir","ove","core-of-standard"]},"description":"라인(갈래)"},{"name":"size","in":"query","required":false,"schema":{"type":"string"},"description":"사이즈(예 250)"},{"name":"min","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"최저 값(원)"},{"name":"max","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"최고 값(원)"},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"찾는 말(선택)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20},"description":"몇 개까지(기본 5 · 최대 20)"}],"responses":{"200":{"description":"추천","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string"},"applied":{"type":"array","items":{"type":"string"}},"total":{"type":"integer"},"count":{"type":"integer"},"hint":{"type":["string","null"]},"items":{"type":"array","items":{"allOf":[{"type":"object","properties":{"slug":{"type":"string"},"product_no":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"name_ko":{"type":"string"},"line":{"type":"string"},"line_ko":{"type":"string"},"line_slug":{"type":"string","enum":["coa","tracker","origin","black-noir","ove","core-of-standard"]},"kind":{"type":"string","enum":["더비","부츠","메리제인","스니커즈","로퍼","플랫","슬리퍼","기타"]},"price":{"type":"integer","description":"판매가(원)"},"retail_price":{"type":"integer","description":"정가(원)"},"has_discount":{"type":"boolean"},"currency":{"type":"string","enum":["KRW"]},"availability":{"type":"string","enum":["in_stock","out_of_stock","unknown"]},"page_url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"image_url":{"type":"string"},"image_urls":{"type":"array","items":{"type":"string"}},"summary":{"type":["string","null"]},"description":{"type":"string"},"materials":{"type":"object","properties":{"upper":{"type":["string","null"]},"lining":{"type":["string","null"]},"insole":{"type":["string","null"]},"outsole":{"type":["string","null"]}}},"height_cm":{"type":["number","null"],"description":"총 굽 높이(cm)"},"sizes":{"type":"array","items":{"type":"string"}},"size_tip":{"type":["string","null"]},"fit_note":{"type":["string","null"]},"wide":{"type":"boolean"},"light":{"type":"boolean"},"gender":{"type":["string","null"]},"occasions":{"type":"array","items":{"type":"string"}},"color":{"type":["string","null"],"description":"색 이름(예 \"블랙 (Black)\")"},"rain_ok":{"type":"boolean","description":"고무창이라 약한 비는 무리 없음"},"target_user":{"type":["string","null"],"description":"이런 분께(원문)"},"recommend":{"type":"object","description":"AI 가 그대로 말해도 되는 추천 근거(사실 칸만)","properties":{"for":{"type":"array","items":{"type":"string"}},"why":{"type":"array","items":{"type":"string"}},"caution":{"type":"array","items":{"type":"string"}}}},"musinsa_review_url":{"type":["string","null"],"format":"uri","description":"구매 후기는 무신사 상품 쪽에"}}},{"type":"object","properties":{"reasons":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"sizes_in_stock":{"type":["array","null"],"items":{"type":"string"}}}}]}}}}}}},"400":{"description":"조건 없음"}}}},"/api/ai/store":{"get":{"operationId":"getStoreInfo","summary":"가게 정보(브랜드 · 라인 · 배송 · 교환 · 사이즈 보는 법 · 회사)","responses":{"200":{"description":"가게 정보","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string"},"store":{"type":"object"}}}}}}}}},"/recommend.md":{"get":{"operationId":"recommendMarkdown","summary":"손님 조건으로 추천(글 꼴 · 주소만 열면 됨)","description":"/api/ai/recommend 와 같은 인자 · 상품마다 근거·이런 분께·포인트·주의·살 수 있는 사이즈.","parameters":[{"name":"gender","in":"query","required":false,"schema":{"type":"string","enum":["male","female","unisex"]},"description":"성별"},{"name":"occasion","in":"query","required":false,"schema":{"type":"string"},"description":"상황"},{"name":"needs","in":"query","required":false,"schema":{"type":"string"},"description":"필요(쉼표)"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["더비","부츠","메리제인","스니커즈","로퍼","플랫","슬리퍼","기타"]},"description":"종류"},{"name":"size","in":"query","required":false,"schema":{"type":"string"},"description":"사이즈"},{"name":"max","in":"query","required":false,"schema":{"type":"integer"},"description":"최고 값"}],"responses":{"200":{"description":"추천(마크다운)","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"인자 없음 · 쓰는 법","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/ai/lines":{"get":{"operationId":"listLines","summary":"라인(갈래) 목록","responses":{"200":{"description":"라인","content":{"application/json":{"schema":{"type":"object","properties":{"lines":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"name_ko":{"type":"string"},"concept":{"type":"string"},"count":{"type":"integer"},"url":{"type":"string"}}}}}}}}}}}},"/search.md":{"get":{"operationId":"searchMarkdown","summary":"상품 찾기(글 꼴 · 주소만 열면 됨)","description":"/api/ai/products 와 같은 인자 · 줄마다 이름·값·라인·종류·소재·굽 + 상품 글 꼴 주소.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"찾는 말"},{"name":"line","in":"query","required":false,"schema":{"type":"string","enum":["coa","tracker","origin","black-noir","ove","core-of-standard"]},"description":"라인"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["더비","부츠","메리제인","스니커즈","로퍼","플랫","슬리퍼","기타"]},"description":"종류"},{"name":"size","in":"query","required":false,"schema":{"type":"string"},"description":"사이즈"},{"name":"max","in":"query","required":false,"schema":{"type":"integer"},"description":"최고 값"}],"responses":{"200":{"description":"결과(마크다운)","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"인자 없음 · 쓰는 법","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/product/{slug}.md":{"get":{"operationId":"productMarkdown","summary":"상품 하나(글 꼴)","description":"같은 상품 쪽 주소(/product/{slug})에 Accept: text/markdown 을 보내도 됩니다.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"상품(마크다운)","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"없는 상품"}}}}}}