{"openapi":"3.0.3","info":{"title":"APICK 앱 리뷰 조회","version":"1.0.0","description":"앱스토어에 등록된 앱의 정보(평점·평가 수·가격·장르)와 고객 리뷰를 한 번에 받습니다. 앱 ID 하나로 앱 개요와 최신 리뷰를 함께 확인할 때 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/app_reviews":{"post":{"summary":"앱 리뷰 조회","description":"앱스토어에 등록된 앱의 정보(평점·평가 수·가격·장르)와 고객 리뷰를 한 번에 받습니다. 앱 ID 하나로 앱 개요와 최신 리뷰를 함께 확인할 때 씁니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"appId":{"type":"string"},"country":{"type":"string"},"page":{"type":"integer"},"app":{"type":"object","properties":{"name":{"type":"string"},"sellerName":{"type":"string"},"price":{"type":"integer"},"averageUserRating":{"type":"number"},"userRatingCount":{"type":"integer"},"genres":{"type":"array","items":{"type":"string"}}}},"reviews":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"author":{"type":"string"},"rating":{"type":"integer"},"version":{"type":"string"},"title":{"type":"string"},"content":{"type":"string"},"updated":{"type":"string"}}}},"reviewCount":{"type":"integer"}}},"api":{"type":"object","properties":{"cost":{"type":"integer"},"success":{"type":"boolean"},"ms":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"appId":{"type":"string","description":"앱스토어 앱 ID (숫자) (string)","example":"362057947"},"country":{"type":"string","description":"국가 코드 (기본 kr) (string)","example":"kr"},"page":{"type":"string","description":"리뷰 페이지 (기본 1, 최대 10) (integer)"}},"required":["appId"]}}}}}}},"x-code-tables":[{"title":"응답과 오류 복구","columns":["필드","타입","설명"],"rows":[["data.appId","string","요청한 앱 ID입니다."],["data.country","string","조회한 앱스토어 국가 코드입니다."],["data.page","integer","조회한 리뷰 페이지입니다."],["data.app","object","앱 정보입니다. 찾지 못하면 null입니다."],["data.app.name","string","앱 이름입니다."],["data.app.sellerName","string","제공자 이름입니다."],["data.app.price","number","판매 가격입니다. 무료는 0입니다."],["data.app.averageUserRating","number","평균 평점입니다. 평가가 없으면 null입니다."],["data.app.userRatingCount","integer","평가 수입니다."],["data.app.genres[]","array","장르 목록입니다."],["data.reviews[]","array","리뷰 목록입니다. 리뷰가 없으면 빈 배열입니다."],["data.reviews[].rating","integer","별점 1~5입니다."],["data.reviews[].content","string","리뷰 본문입니다."],["data.reviews[].updated","string","작성 시각입니다."],["data.reviewCount","integer","이번 응답에 담긴 리뷰 수입니다."],["api.cost","integer","차감된 포인트입니다. 실패한 응답은 0입니다."],["api.ms","integer","처리 시간(밀리초)입니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}