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
}