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

    product id

    String

    M

    十位数数字

    0000252337

    商品的PID(数字)

  • 商品搜索查看的引用

    command

    onestore://common/search/{query}
    ParameterTypeMandatoryLimitsampleDescription

    搜索词

    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)
refTypereferrercallerType备注

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

ParameterTypeMandatoryLimitsampleDescription

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

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

商品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