# Deep Link Integration Guide

Swing2App offers deep link functionality for **Push-Only Apps**, allowing you to launch the app or redirect users to specific URLs.\
This guide explains how to implement deep links, encode URLs, and locate your app ID for integration.

***

## ✅ Basic Deep Link Structure

The basic format for using Swing2App’s deep link is as follows:

```
https://www.swing2app.com/swapi/openAppWithUrl?appId={app_id}
```

* `{app_id}` should be replaced with your app’s unique ID (how to find it is explained below).
* This URL launches the app without directing to a specific page.
* If the app is **not installed**, the user will be redirected to either the **Google Play Store or Apple App Store** depending on their device.

***

## ✅ Adding a Target URL to the Deep Link

To launch the app and open a specific page, you can append the `url` parameter.

```
https://www.swing2app.com/swapi/openAppWithUrl?appId={app_id}&url=https://m.naver.com
```

### ℹ️ Note:

* The `url` parameter must be **URL-encoded**.
* Example:\
  Here is how the URL should look after encoding:

```
✅ Before encoding:
https://google.com

✅ After encoding:
https%3A%2F%2Fgoogle.com
```

* You can encode the URL using tools like `encodeURIComponent()` in JavaScript or any online URL encoder.

***

## ✅ POST Method Support

Deep links can be invoked via both **GET** and **POST** methods.\
This is useful when you want to avoid exposing parameters in the URL or need more secure communication.

***

## ✅ How to Find Your App ID (appId)

Only users who have purchased a subscription (paid apps) can access the appId.

### Navigation Path:

```
App Management > Service Management > App Operations > Advanced App Management > API-KEY Management
```

* On this page, you’ll find the `appId` and other API credentials.
* Free users or unpaid apps will not have access to the appId and cannot use the deep link feature.

***

## ✅ Example Deep Links

### App Launch Only (Redirects to store if not installed)

```
https://www.swing2app.com/swapi/openAppWithUrl?appId=275a02bc-9a02-4f9e-b54c-077d056e2cb1
```

### App Launch + Open Specific Page

```
https://www.swing2app.com/swapi/openAppWithUrl?appId=275a02bc-9a02-4f9e-b54c-077d056e2cb1&url=https%3A%2F%2Fm.naver.com
```

***

## ✅ Important Notes

* If the app is not installed, users will be redirected to the appropriate app store.
* Make sure the app is updated to the **latest version** to ensure the deep link functions properly.
* Push-only apps support limited features and may not fully support in-app navigation using WebViews.

***

## 📌 Conclusion

With Swing2App’s deep link support, even Push-Only Apps can implement powerful marketing features such as app launches, in-app redirection, and app store navigation.


---

# 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://documentation.swing2app.com/developer/webview/deep-link-integration.md?ask=<question>
```

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.