Reference

术语介绍

主要术语	说明	备注
PID	为Product ID的简称，如果新增应用内商品，系统则会发行固有应用内商品的固有ID	留意与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连接的引用

• 商品详细查看的引用

  command

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

  Parameter	Type	Mandatory	Limit	sample	Description
  product id	String	M	十位数数字	0000252337	商品的PID（数字）

• 商品搜索查看的引用

  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商店会员操作，系统才会有反应。

• • 用户若不是会员，或者失败登录，将显示登录画面。

• • 收费应用：已有购买记录才可启动。

• • 免费应用：自动进行购买处理，并下载。

查询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
}