레퍼런스

용어정리

필수 용어	설명	비고
PID	Product ID의 줄임말로, Application 등록 시 자동으로 발급되는 고유한 ID 값입니다.	AID와 혼동 유의.

지원 클라이언트 버전

대한민국

스토어 버전	비고	패키지네임	지원버전
T store	-	com.skt.skaf.A000Z00040	Version Name = 5.0.0 / Version Code = 50000 이상
olleh마켓	프리로드 버전	com.kt.olleh.storefront	Version Name = 5.0.0 / Version Code = 50000 이상
U+스토어	LTE 단말	com.lguplus.appstore	Version Name = 5.0.0 / Version Code = 50000 이상

대한민국 외 다른 국가

스토어 버전	비고	패키지네임	지원버전
싱가폴/대만	-	com.onestorecorp.gaa.storeapp	모든 버전 지원
미국	-	com.dti.folderlauncher	Version Name = 4.0.0 / Version Code = 400000 이상

URL scheme 연동 Reference

• 상품 상세뷰 Reference

  명령어

  onestore://common/product/{product id}

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

• 상품 검색뷰 Reference

  명령어

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

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

• 업데이트 요청

  명령어

  onestore://common/product/bg_update/{product id}

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

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

    • 업데이트는 Background에서 진행되고 Noti를 통해 진행사항을 보여준다.

    • 최신버전이 이미 설치된 경우 요청을 무시한다.

    • 회원 기반 동작이므로 이용자가 원스토어 회원인 경우에 동작한다.

    • 회원이 아니거나 로그인에 실패한 경우 인증을 위한 로그인 화면이 자동 실행된다.

    • 유료앱은 구매이력이 이미 있는 경우에 동작한다.

Server side API

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

  command

  https://oneapi.onestore.net/api/devcenter/getAppVersion/v1?pkgNm={패키지네임}&deviceModelCd={모델명}&osVer={OS버전}&sdkVersion={SDK버전}

  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버전
  sdkVersion	String	O	5	30	단말 OS별 sdkVersion 정보

deviceModelCd를 입력한 경우 osVer도 반드시 입력해주세요.

• Response Parameters

  Name	Mandatory	Type	Description
  result		M	Object	응답 결과 정보
  	code	M	String	응답 코드 000 : success 100 : no data 200 : server error 400 : bad request 509 : server busy
  	desc	M	String	응답 메시지
  prodId		M	String	상품ID
  verNm		M	String	앱 버전
  verCd		M	String	앱 버전 코드
  longVerCd			String	Version Code Android OS 버전이 Pie 이상이고 Major Version Code 등록된 경우 아래와 같이 응답 Major Version Code와 versionCode 병합한 버전 코드 (((long) major) << 32) | (((long) minor) & 0xffffffffL) 그외는 "verCd"와 동일한 값이 응답 됨
  title		M	String	상품명
  topMenuId		M	String	Version Name, 디바이스 이름, OS버전을 등록해야만 나옴
  topMenuNm		M	String	Version Code, 디바이스 이름, OS버전을 등록해야만 나옴
  menuId		M		최상위 카테고리 코드
  menuNm		M	String	최상위 카테고리 네임
  sellerNm		M	String	판매자 명
  game		M	boolean

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

  {
      "result": {
          "code": "000",
          "desc": "success"
      },
      "prodId": "0000758646",
      "verNm": "1.36.120365",
      "verCd": "120365",
      "title": "블루 아카이브",
      "topMenuId": "DP01",
      "topMenuNm": "게임",
      "menuId": "DP01004",
      "menuNm": "롤플레잉",
      "sellerNm": "(주) 넥슨",
      "game": true
  }