Tools Reference - ONE-store/inapp-sdk-eng GitHub Wiki

Terminology

Required Terminology Description Remarks
PID PID stands for Product Identifier. It is a unique ID value issued for an In-App product once the In-App product is added to and published for an uploaded App. The PID must not be confused with the AID

Support Client Version

Store Version Remarks Package Name Support Version
T store - com.skt.skaf.A000Z00040 Versionname : Version name : 4.54, version code : above 121
Olleh Market Freeload version com.kt.olleh.storefront Version code: 4101, version name: above 4.1.01
Olleh Market Install version com.kt.olleh.istore Version code: 4001, version name: above 4.0.01
U+Store LTE device com.lguplus.appstore Version Name = 02.00.00 / Version Name = 02.00.00 / Version Code = above 20000
U+Store 3G device android.lgt.appstore Version Name = 02.00.00 / Version Name = 02.00.00 / Version Code = above 20000

Designate Store (Deprecated)

The content below has been Deprecated. It is recommended to use common only as the delimiter for store selection.

onestore://{store selection }/product/{product PID}?view_type={value}
Store Selection Case Action
common If only one store Client is installed Immediately connect to the corresponding store.
common If more than 2 store Clients are installed Select an App selection window and the store the user wants
tstore

ollehmarket

uplusstore		 If only one store Client is installed Immediately connect to the corresponding store, if the corresponding store’s Client is installed.

Stop working if the corresponding store’s Client is not installed (no response).
tstore

ollehmarket

uplusstore		 If more than 2 store Clients are installed Immediately connect to the corresponding store, if the corresponding stores’ Clients are installed.

Stop working if the corresponding store’s Clients are not installed (no response).

Sample


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 Connection Reference

1. Product Detail View Reference

command onestore://common/product/{product id}?[view_type={view_type}]

Parameter Type Mandatory Limit sample Description
product id String M 10 digit number 0000252337 This is the Product PID (numerical ID)
view_type integer O 1 1 view_type=1 : moves to user reviews
view_type=2 : moves to related products
view_type=3 : automatic installation

The automatic installation starts after being moved to the detail page and the user is identified (do you want to install A?).
(1) The automatic installation occurs for the products that have already been purchased (reinstalled even if it is already installed) (2) If a product is for free and has no purchase history, a purchase history is automatically generated and then automatically installed. (3) If a product is for charge, move to the payment page (the user identification window is not needed because automatic installation does not start).


2. Product Search View Reference

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

Parameter Type Mandatory Limit sample Description
Query String M 20 byte Naver App Enter query

3. Request Update

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

Parameter Type Mandatory Limit sample Description
product id String M 10 digit number 0000252337 This is the Product PID (numerical ID)

Note for Update Request Specification

  1. Update takes place in Background, and progress is shown through Noti.
  2. Requests are ignored if the latest version has already been installed.
  3. It operates only when the user has a ONE store membership since it works based on the membership.
  4. If you do not have the membership or fail to sign up, a login screen for authentication is automatically executed.
  5. It operates if a paid App already has the purchase history.
  6. It automatically processes and downloads a free App.

4. Check referrer Statistics

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

refType referrer callerType Remarks
1 package name 7: Android app
8: web browser
9: text message (SMS)
10: push message(GCM, etc.)
11: advertising network (T-AD, etc,)		 This calls the PKG name in an App. Otherwise, it is recommended to call the types of URL (UTF-8).
2 URL Same above Same above
3 Partner company’s name + PID 15 It is recommended to use for a separate partner marketing.

Server side API

Check PID & Version Name with packageName

command http://m.onestore.co.kr/mobilepoc/api/getAppVersion.omp?pkgNm={Package Name}&deviceModelCd={Model name}&osVer={OS version}

Request Parameters

Parameter Type Mandatory Limit sample Description
pkgNm String M ??100 com.nhn.android.search This is the package name of the App
deviceModelCd String O ??100 SM-N920S This is the model name of the device
osVer String O 5 6.0.1 This is the OS version of the device

Response Parameters

Parameter Type Mandatory sample Description
menuId String M DP04202 This is the detailed category code
menuNm String M information/common sense This is the detailed category name
game T/F M false If it falls into the game category or not
result - M - -
desc String M success This is the result message
code String M 000 This is the result code (refer to the below)
prodId String M 0000252337 This is the product PID
title String M naver - NAVER This is the product name
verNm String O 7.3.2 This comes only when the version name, device name, and OS version are registered
verCd String O 732 This comes only when the version code, device name, and OS version are registered
topMenuId String M DP30 This is the top-level category code
topMenuNm String M App This is the top-level category name
sellerNm String M NAVER Corp. This is the publisher’s name

Response if Model Name Is Not Entered

{
    "menuId": "DP04202",
    "game": false,
    "result": {
        "desc": "success",
        "code": "000"
    },
    "verNm": "",
    "verCd": "",
    "topMenuId": "DP30",
    "topMenuNm": "app",
    "menuNm": "information/common sense",
    "sellerNm": "NAVER Corp.",
    "prodId": "0000030320",
    "title": "naver  - NAVER"
}

Response if Model Name Is Entered

{
    "menuId": "DP04202",
    "game": false,
    "result": {
        "desc": "success",
        "code": "000"
    },
    "verNm": "7.3.2",
    "verCd": "732",
    "topMenuId": "DP30",
    "topMenuNm": "app",
    "menuNm": "information/common sense ",
    "sellerNm": "NAVER Corp.",
    "prodId": "0000030320",
    "title": "naver  - NAVER"
}
⚠️ **GitHub.com Fallback** ⚠️