{"openapi":"3.0.3","info":{"title":"APICK 앱 리뷰 조회","version":"1.0.0","description":"iOS 앱의 정보(평점·평가 수·가격·장르)와 고객 리뷰를 한 번에 받습니다. 앱 ID 하나로 앱 개요와 최신 리뷰를 함께 확인할 때 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/app_reviews":{"post":{"summary":"앱 리뷰 조회","description":"iOS 앱의 정보(평점·평가 수·가격·장르)와 고객 리뷰를 한 번에 받습니다. 앱 ID 하나로 앱 개요와 최신 리뷰를 함께 확인할 때 씁니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"appId":{"type":"string","description":"요청한 앱 ID(숫자만)입니다."},"country":{"type":"string","description":"조회한 국가 코드(소문자)입니다."},"page":{"type":"integer","description":"실제로 조회한 리뷰 페이지입니다. 범위를 벗어난 값은 1 또는 10으로 바뀌어 옵니다."},"app":{"type":"object","properties":{"appId":{"type":"string","description":"앱 ID입니다."},"name":{"type":"string","description":"앱 이름입니다."},"sellerName":{"type":"string","description":"제공자 이름입니다."},"bundleId":{"type":"string","description":"앱 번들 ID입니다."},"price":{"type":"integer","description":"판매 가격입니다. 무료는 0이고, 값이 없으면 null입니다.","nullable":true},"currency":{"type":"string","description":"가격 통화입니다(예: KRW)."},"averageUserRating":{"type":"number","description":"평균 평점입니다. 평가가 없으면 null입니다.","nullable":true},"userRatingCount":{"type":"integer","description":"평가 수입니다. 평가가 없으면 null 또는 0입니다.","nullable":true},"genres":{"type":"array","items":{"type":"string"},"description":"장르 이름 목록입니다."},"version":{"type":"string","description":"현재 버전입니다."},"releasedAt":{"type":"string","description":"현재 버전 출시 시각(ISO 8601)입니다."},"artworkUrl":{"type":"string","description":"앱 아이콘 이미지 주소입니다."},"url":{"type":"string","description":"앱 상세 페이지 주소입니다."}},"description":"앱 정보입니다. 해당 국가에서 앱 정보를 찾지 못하면 null일 수 있습니다.","nullable":true},"reviews":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"리뷰 ID입니다. 중복 저장을 막는 키로 씁니다."},"author":{"type":"string","description":"작성자 표시 이름입니다."},"rating":{"type":"integer","description":"별점 1~5입니다. 읽지 못하면 null입니다.","nullable":true},"version":{"type":"string","description":"리뷰를 쓴 시점의 앱 버전입니다. 없으면 빈 문자열입니다."},"title":{"type":"string","description":"리뷰 제목입니다."},"content":{"type":"string","description":"리뷰 본문입니다."},"updated":{"type":"string","description":"작성 시각입니다. 시간대가 붙은 ISO 8601 형식이 기본이며, 날짜로 해석해 저장하세요."}}},"description":"리뷰 목록(최신순)입니다."},"reviewCount":{"type":"integer","description":"이번 응답에 담긴 리뷰 수입니다. data.reviews 길이와 같습니다."},"success":{"type":"integer","description":"과금 여부입니다. 성공하면 1, 실패하면 0입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패한 응답은 0입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"결제 기록 번호입니다. 문의할 때 함께 알려 주세요."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"appId":{"type":"string","description":"조회할 iOS 앱의 숫자 ID입니다. 앱 링크의 /id 뒤 숫자를 사용하며, Android 패키지명과 다릅니다. (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":["상황","HTTP","data.error","해결"],"rows":[["앱 ID 형식 오류","400","입력 항목이 잘못됐습니다. 앱 ID(숫자, 예: 362057947)를 입력해 주세요.","앱 상세 주소 끝의 숫자(12자리 이하)를 보냅니다. 앱 이름이나 번들 ID를 넣지 않았는지 확인합니다."],["국가 코드 오류","400","입력 항목이 잘못됐습니다. 국가 코드(2자리, 예: kr)를 확인해 주세요.","kr·us처럼 영문 두 글자로 보내거나 생략합니다."],["앱 없음","404","해당 앱을 찾을 수 없습니다. 앱 ID 와 국가 코드를 확인해 주세요.","앱 ID를 확인하고, 그 나라에 출시된 앱인지 country를 바꿔 확인합니다."],["1페이지 리뷰를 받지 못함","424","앱 리뷰를 일시적으로 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다."],["2페이지 이후 리뷰를 받지 못함","424","요청한 페이지의 리뷰를 가져오지 못했습니다. 리뷰가 그보다 적거나 일시적인 문제일 수 있으니 page 를 줄이거나 잠시 후 다시 시도해 주세요.","리뷰가 그 페이지까지 없을 수 있으니 page를 줄입니다. 바로 앞 페이지가 받아졌다면 잠시 후 다시 시도합니다."],["일시적 조회 실패","424","앱 리뷰 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}