Reference

用語

Required Terminology
Description
Remarks

PID

PID 代表產品識別碼。這是一個在應用程式註冊時自動發放的唯一 ID 值。

PID 不應與 AID 混淆。

支援客户端版本

大韓民國

商店版本
備註
套件包名稱
支援版本

T store

-

com.skt.skaf.A000Z00040

Version Name = 5.0.0 / Version Code = 50000 以上

Olleh Market

預載版本

com.kt.olleh.storefront

Version Name = 5.0.0 / Version Code = 50000 以上

U+Store

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 以上

選定商店(Deprecated)

  • 以下內容不建議使用（Deprecated處理） 作為選定商店的分隔符，建議使用common方式。 

    onestore://{store selection }/product/{product PID}?view_type={value}
    選定商店
    假設
    動作

    common

    只安裝一個應用程式商品客戶端時

    立即連動相應商店

    common

    已安裝兩個以上的應用程式商品客戶端時

    首先顯示一個畫面，可自行選擇欲連動的商品

    tstore

    ollehmarket

    uplusstore

    只安裝一個應用程式商品客戶端時

    如果已安裝相應商店客戶端，立即連動

    如果未安裝相應商店客戶端，停止操作（無回應）

    tstore

    ollehmarket

    uplusstore

    已安裝兩個以上的應用程式商品客戶端時

    如果已安裝相應商店客戶端，立即連動

    如果未安裝相應商店客戶端，停止操作（無回應）

    示例

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

關於URL scheme連動 Reference

  • 商品詳細查看 Reference

    command

    onestore://common/product/{product id}
    Parameter
    Type
    Mandatory
    Limit
    sample
    Description

    product id

    String

    M

    十位數字

    0000252337

    商品的PID（數字）

  • 商品搜尋查看 Reference

    command

    onestore://common/search/{query}
    Parameter
    Type
    Mandatory
    Limit
    sample
    Description

    關鍵字

    String

    M

    10 digit number

    0000252337

    輸入關鍵字

  • 請求更新

    command

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

    Parameter

    Type

    Mandatory

    Limit

    sample

    Description

    product id

    String

    M

    十位數字

    0000252337

    商品的PID（數字）

  • 請求更新時規格的參考事項

    • 更新在Background進行，通過提示（Noti）告知進行過程。

    • 若已經安裝最新版本，將無視更新請求。

    • 該動作只針對會員，故系統只有是ONE Store會員才會有反應。

    • 若用戶不是會員或是登入失敗，為了進行認證將自動顯示登入畫面。

    • 收費應用程式：已有購買紀錄才可啟動。

    • 免費應用程式：自動進行購買處理並下載。

查詢referrer統計

command

onestore://common/{Individual connection commands}?refType=(Int)&referrer=(STRING)&callerType=(INT)

refType
referrer
callerType
備註

1

package name

7: Android app 8: 網頁瀏覽器 9: 短信(SMS) 10: 推播訊息（GCM 等） 11: 廣告網路 (T-AD 等）

通過應用程式呼叫時，建議使用套件包名稱（PKG Name），除此之外都使用URL (UTF-8)呼叫

2

URL

相同

相同

3

合作夥伴名稱 + PID

如果與合作夥伴共同進行行銷活動，建議使用該方法

伺服器 API

使用套件包名（packageName）確認PID及版本名稱

command

https://oneapi.onestore.net/api/devcenter/getAppVersion/v1?pkgNm={Packagename}&deviceModelCd={ModelName}&osVer={OS version}&sdkVersion={SDK version}

Request Parameters

Parameter
Type
Mandatory
Limit
sample
Description

pkgNm

String

M

??100

com.nhn.android.search

應用程式的套件包名稱

deviceModelCd

String

O

??100

SM-N920S

osVer

String

O

5

6.0.1

終端設備的OS版本

sdkVersion

String

O

5

30

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

商品PID

verNm

M

String

應用程式版本名稱，只有註冊終端設備名稱和OS版本才會顯示

verCd

M

String

應用程式版本代碼（請見下面說明）

longVerCd

String

  • Version Code

    • Android OS版本為Pie以上且已註冊Major Version Code時，回應如下。

    • Major Version Code 和 version Code 合併版本代碼

      • (((long) major) << 32) | (((long) minor) & 0xffffffffL)

    • 此外，回應與"verCd"相同的值

title

M

String

商品名稱

topMenuId

M

String

版本名稱，只有註冊終端設備名稱和OS版本才會顯示

topMenuNm

M

String

版本名稱，只有註冊終端設備名稱和OS版本才會顯示

menuId

M

最大分類代碼

menuNm

M

String

最大分類名稱

sellerNm

M

String

銷售者名稱

game

M

boolean

不輸入型號時的回應

{
    "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