레퍼런스

용어정리

필수 용어설명비고

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}
    ParameterTypeMandatoryLimitsampleDescription

    product id

    String

    M

    숫자 10자

    0000252337

    상품의 PID (숫자형)

  • 상품 검색뷰 Reference

    명령어

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

    검색어

    String

    M

    20 byte

    네이버앱

    검색어 입력

  • 업데이트 요청

    명령어

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

    product id

    String

    M

    숫자 10자

    0000252337

    상품의 PID (숫자형)

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

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

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

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

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

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

Server side API

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

    command

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

    Request Parameters

    ParameterTypeMandatoryLimitsampleDescription

    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

    NameMandatoryTypeDescription

    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