{"openapi":"3.1.0","info":{"title":"식권대장 Developer API","version":"1.0.0","description":"송파 IT벤처타워와 가락시장역 주변 식당 카탈로그를 읽는 공개 read-only API입니다. 식당 추가·수정·삭제는 지원하지 않습니다.","contact":{"name":"식권대장 운영팀 (KOSA)","email":"rlawnsgk0610@gmail.com"}},"servers":[{"url":"https://sikdae-kosa.vercel.app","description":"Production"}],"paths":{"/api/restaurants":{"get":{"operationId":"listRestaurants","summary":"식당 목록 또는 식당 상세 조회","description":"id가 없으면 전체 식당 목록을 반환하고, view=summary이면 목록 화면에 필요한 가벼운 메뉴 요약만 반환합니다. id를 지정하면 한 식당의 상세 정보와 가능한 외부 데이터 병합 결과를 반환합니다.","parameters":[{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["summary"]},"description":"summary를 사용하면 이미지가 제외된 목록용 응답을 반환합니다."},{"name":"id","in":"query","required":false,"schema":{"type":"string"},"description":"식당 식별자. 존재하지 않으면 404를 반환합니다."}],"responses":{"200":{"description":"식당 목록 또는 상세 정보","content":{"application/json":{"schema":{"oneOf":[{"type":"array"},{"type":"object"}]}}}},"404":{"description":"식당 ID를 찾을 수 없음","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}},"tags":[{"name":"restaurants","description":"읽기 전용 식당 카탈로그"}],"externalDocs":{"description":"식권대장 개발자 안내","url":"https://sikdae-kosa.vercel.app/developers"}}