한국어
Search
⌃K
Comment on page

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 以上
Olleh Market
安装版本
com.kt.olleh.istore
Version Name = 5.0.0 / Version Code = 50000 以上
U+Store
LTE终端
com.lguplus.appstore
Version Name = 5.0.0 / Version Code = 50000 以上
U+Store
3G终端
android.lgt.appstore
Version Name = 5.0.0 / Version Code = 50000 以上

选定商店(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://openapi.onestore.co.kr/api/devcenter/getAppVersion/v1?pkgNm={PackageName}&deviceModelCd={Model name}&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
Text
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 modified 7mo ago