# 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.
{% hint style="success" %}
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
{% endhint %}
### **URL Scheme Configuration**
* For more on each call specification, refer to Tools [Reference.](https://onestore-dev.gitbook.io/dev/chi/tools/app-links/reference)
### **App/Game Detail Call**
* In Product View, the clients of each mobile operator move to ‘See Details’ screen for the corresponding PID (‘See Details’ screen of a single product).
{% tabs %}
{% tab title="Specification" %}
`onestore://common/product/{상품PID}`
{% endtab %}
{% tab title="Sample" %}
`onestore://common/product/0000252337`
{% endtab %}
{% endtabs %}
* #### **Search Call**
* In Search View, the ONE store App shows the search result screen for the corresponding query.
{% tabs %}
{% tab title="Specification" %}
`onestore://common/search/{query}`
{% endtab %}
{% tab title="Sample" %}
`onestore://common/search/naver app`
{% endtab %}
{% endtabs %}
* #### 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 package name of the product to request update does match the package name of the product to be downloaded.
{% tabs %}
{% tab title="Specification" %}
`onestore://common/product/bg_update/{PID}`
{% endtab %}
{% tab title="Sample" %}
`onestore://common/product/bg_update/0000252337`
{% endtab %}
{% endtabs %}
### **Connection to Shorten URLs**
* You can easily generate a connection address of App detail page by using PID.
Specification
{% tabs %}
{% tab title="Specification" %}
`https://onesto.re/{PID}`
{% endtab %}
{% tab title="Sample" %}
`https://onesto.re/0000252337`
{% endtab %}
{% endtabs %}
{% hint style="success" %}
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.
{% endhint %}
| Current Spec. | Redirect | New Spec. |
| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
|  |  |  |
### **Server side API**
* #### **Check PID & Version Name with packageName**
* The API must be called using the **GET** method.
* 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.](https://onestore-dev.gitbook.io/dev/chi/tools/app-links/reference)
{% tabs %}
{% tab title="Request Specification" %}
`GET https://oneapi.onestore.net/api/devcenter/getAppVersion/v1?pkgNm={package name}&deviceModelCd={model name}&osVer={OS version}&sdkVersion={SDK version}`
{% endtab %}
{% tab title="Request Sample" %}
`https://oneapi.onestore.net/api/devcenter/getAppVersion/v1?pkgNm=com.nexon.bluearchiveone&deviceModelCd=SM-N960N&osVer=11.0&sdkVersion=30`
{% endtab %}
{% tab title="Response Sample" %}
```java
{
"result": {
"code": "000",
"desc": "success"
},
"prodId": "0000758646",
"verNm": "1.36.120365",
"verCd": "120365",
"title": "블루 아카이브",
"topMenuId": "DP01",
"topMenuNm": "게임",
"menuId": "DP01004",
"menuNm": "롤플레잉",
"sellerNm": "(주) 넥슨",
"game": true
}
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://onestore-dev.gitbook.io/dev/chi/tools/app-links.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.