레퍼런스

용어정리

필수 용어

설명

비고

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 이상

olleh마켓

인스톨 버전

com.kt.olleh.istore

Version Name = 5.0.0 / Version Code = 50000 이상

U+스토어

LTE 단말

com.lguplus.appstore

Version Name = 5.0.0 / Version Code = 50000 이상

U+스토어

3G 단말

android.lgt.appstore

Version Name = 5.0.0 / Version Code = 50000 이상

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
}

Last updated 2 months ago