Tools Reference

용어정리

필수 용어	설명	비고
PID	Product ID의 줄임말로, 등록한 Application에서 판매할 In-App상품을 추가하면 발급되는 고유한 In-App상품 ID 값이다.	AID와 혼동을 유의한다.

지원 클라이언트 버전

스토어 버전	비고	패키지네임	지원버전
T store	-	com.skt.skaf.A000Z00040	Versionname : 4.54 versioncode : 121 이상
olleh마켓	프리로드 버전	com.kt.olleh.storefront	버전 코드: 4101, 버전 네임: 4.1.01 이상
olleh마켓	인스톨 버전	com.kt.olleh.istore	버전 코드: 4001, 버전 네임: 4.0.01 이상
U+스토어	LTE 단말	com.lguplus.appstore	Version Name = 02.00.00 / Version Code = 20000 이상
U+스토어	3G 단말	android.lgt.appstore	Version Name = 02.00.00 / Version Code = 20000 이상

스토어 지정 (Deprecated)

아래 내용은 Deprecated 되었습니다.
스토어선택 구분자로 common 만을 사용할것을 권장합니다.

onestore://{스토어선택}/product/{상품PID}?view_type={값}

스토어선택	Case	동작
common	스토어 Client가 하나만 설치된 경우	해당 스토어로 바로 연동
common	스토어 Client가 2개이상 설치된 경우	앱 선택창, 사용자가 원하는 스토어를 선택
tstore ollehmarket uplusstore	스토어 Client가 하나만 설치된 경우	해당 스토어 Client가 설치되어 있으면 바로 연동 해당 스토어 Client가 설치되어 있지 않으면 작동 중지 (응답없음)
tstore ollehmarket uplusstore	스토어 Client가 2개이상 설치된 경우	해당 스토어 Client가 설치되어 있으면 바로 연동 해당 스토어 Client가 설치되어 있지 않으면 작동 중지 (응답없음)

샘플

onestore://common/product/{상품PID}?view_type={view_type}
onestore://tstore/product/{상품PID}?view_type={view_type}
onestore://ollehmarket/product/{상품PID}?view_type={view_type}
onestore://uplusstore/product/{상품PID}?view_type={view_type}

URL scheme 연동 Reference

1. 상품 상세뷰 Reference

명령어 onestore://common/product/{product id}?[view_type={view_type}]

Parameter	Type	Mandatory	Limit	sample	Description
product id	String	M	숫자 10자	0000252337	상품의 PID (숫자형)
view_type	integer	O	1	1	view_type=1 : 사용후기로 이동 view_type=2 : 연관상품으로 이동 view_type=3 : 자동설치

자동 설치는 상세페이지 이동 뒤, 사용자 확인 후 진행됩니다. ( A를 설치하시겠습니까? ) (1) 기구매 상품인 경우 자동설치 (기존에 설치되어 있어도 재설치) (2) 무료 상품이고, 구매이력이 없는 경우 구매 이력 자동 생성 후 자동설치 (3) 유료인 경우, 결제페이지로 이동 ( 자동 설치 미진행이므로, 사용자 확인 창은 불필요 )

2. 상품 검색뷰 Reference

명령어 onestore://common/search/{검색어}

Parameter	Type	Mandatory	Limit	sample	Description
검색어	String	M	20 byte	네이버앱	검색어 입력

3. 업데이트 요청

명령어 onestore://common/product/bg_update/{product id}

Parameter	Type	Mandatory	Limit	sample	Description
product id	String	M	숫자 10자	0000252337	상품의 PID (숫자형)

업데이트 요청 규격 참고사항

1. 업데이트는 Background에서 진행되고 Noti를 통해 진행사항을 보여준다.
2. 최신버전이 이미 설치된 경우 요청을 무시한다.
3. 회원 기반 동작이므로 이용자가 원스토어 회원인 경우에 동작한다.
4. 회원이 아니거나 로그인에 실패한 경우 인증을 위한 로그인 화면이 자동 실행된다.
   
5. 유료앱은 구매이력이 이미 있는 경우에 동작한다.
   

4. referrer 통계 조회하기

명령어 onestore://common/{개별 연동 명령어}?refType=(Int)&referrer=(STRING)&callerType=(INT)

refType	referrer	callerType	비고
1	package name	7: Android app 8: 웹브라우저 9: 문자메시지(SMS) 10: 푸시메시지(GCM 등) 11: 광고 네트워크 (T-AD 등)	App에서 호출시에는 PKG네임, 그외의 경우에는 URL (UTF-8) 타입으로 호출하기를 권장함.
2	URL	상동	상동
3	제휴사명 + PID	15	별도로 제휴사 마케팅을 하는 경우, 사용하기를 권장함.

Server side API

packageName 으로 PID 및 버전명 확인하기

명령어 http://m.onestore.co.kr/mobilepoc/api/getAppVersion.omp?pkgNm={패키지네임}&deviceModelCd={모델명}&osVer={OS버전}

Request Parameters

Parameter	Type	Mandatory	Limit	sample	Description
pkgNm	String	M	??100	com.nhn.android.search	App의 Package name
deviceModelCd	String	O	??100	SM-N920S	단말의 모델명
osVer	String	O	5	6.0.1	단말의 OS버전

Response Parameters

Parameter	Type	Mandatory	sample	Description
menuId	String	M	DP04202	상세 카테고리 코드
menuNm	String	M	정보/상식	상세 카테고리 네임
game	T/F	M	false	게임 카테고리 인지 아닌지 여부
result	-	M	-	-
desc	String	M	success	결과 메시지
code	String	M	000	결과 코드 (하단 참고)
prodId	String	M	0000252337	상품 PID 아이디
title	String	M	네이버 - NAVER	상품명
verNm	String	O	7.3.2	Version Name, 디바이스 이름, OS버전을 등록해야만 나옴
verCd	String	O	732	Version Code, 디바이스 이름, OS버전을 등록해야만 나옴
topMenuId	String	M	DP30	최상위 카테고리 코드
topMenuNm	String	M	앱	최상위 카테고리 네임
sellerNm	String	M	NAVER Corp.	판매자 명

모델명을 넣지 않았을 떄, Response

{
    "menuId": "DP04202",
    "game": false,
    "result": {
        "desc": "success",
        "code": "000"
    },
    "verNm": "",
    "verCd": "",
    "topMenuId": "DP30",
    "topMenuNm": "앱",
    "menuNm": "정보/상식",
    "sellerNm": "NAVER Corp.",
    "prodId": "0000030320",
    "title": "네이버 - NAVER"
}

모델명을 넣었을 떄, Response

{
    "menuId": "DP04202",
    "game": false,
    "result": {
        "desc": "success",
        "code": "000"
    },
    "verNm": "7.3.2",
    "verCd": "732",
    "topMenuId": "DP30",
    "topMenuNm": "앱",
    "menuNm": "정보/상식",
    "sellerNm": "NAVER Corp.",
    "prodId": "0000030320",
    "title": "네이버 - NAVER"
}