App Links developer guide

Overview

This guide describes URL Scheme connection and various APIs of the ONE store App.

URL Scheme Connection of ONE store App

• You can use URL scheme to open an app download page of ONE store in your mobile apps and browsers. Strings like http://, ftp://, market:// are called URL scheme’ The way to execute an App via the URL scheme is as follows:

  • A URL scheme is passed to Android system when a user clicks a hyperlink with it in an app or a web page

  • The system checks whether there is an app installed in the device which is directly executable through the URL scheme

  • If there is one, the system runs the app, passing over the URL scheme

  • While being executed, the app would perform certain features by referring to the contents included in the URL scheme.

If you use the URL scheme through a mobile browser, you would need to implement an exception handling feature just in case ONE store is not installed in a device

URL Scheme Configuration

• For more on each call specification, refer to Tools Reference.

App/Game Detail Call

• In Product View, the clients of each mobile operator move to ‘See Details’ screen for the corresponding product ID (‘See Details’ screen of a single product).

Specification

onestore://common/product/{상품PID}

Sample

onestore://common/product/0000252337

• Search Call

  • In Search View, the ONE store App shows the search result screen for the corresponding query.

Specification

onestore://common/search/{query}

Sample

onestore://common/search/naver app

• Request Update (Automatic Installation)

  • If the corresponding product is not the latest version, the updated version is automatically downloaded and installed at the update request of App/game products. The update works when the PKG name of the product to request update does match the PKG name of the product to be downloaded.

Specification

onestore://common/product/bg_update/{product ID}

Sample

onestore://common/product/bg_update/0000252337

Connection to Shorten URLs

• You can easily generate a connection address of App detail page by using product ID.

  Specification

Specification

https://onesto.re/{productID}

Sample

https://onesto.re/0000252337

Process Redirects of Current Specification

The current connection specification individually used in each store is automatically redirected. That means, an additional development is separately needed for the currently published products.

Current Spec.	Redirect	New Spec.

Server side API

• Check PID & Version Name with packageName

  • If the product has already been launched, you can check PID and a range of information with packageName openAPI

  • For more detail, refer to Tool Reference.

Request Specification

https://openapi.onestore.co.kr/api/devcenter/getAppVersion/v1?pkgNm={package name}&deviceModelCd={model name}&osVer={OS version}&sdkVersion={SDK version}

Request Sample

https://openapi.onestore.co.kr/api/devcenter/getAppVersion/v1?pkgNm=com.nexon.bluearchiveone&deviceModelCd=SM-N960N&osVer=11.0&sdkVersion=30

Response Sample

{
    "result": {
            "code": "000",
            "desc": "success"
    },
    "prodId": "0000758646",
    "verNm": "1.36.120365",    
    "verCd": "120365",    
    "title": "블루 아카이브",    
    "topMenuId": "DP01",    
    "topMenuNm": "게임",    
    "menuId": "DP01004",    
    "menuNm": "롤플레잉",    
    "sellerNm": "(주) 넥슨",    
    "game": true
}