> For the complete documentation index, see [llms.txt](https://documentation.swing2app.co.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.swing2app.co.kr/developer/webview/deeplink-integration.md).

# 딥링크 기능 구현 가이드

스윙투앱에서 제공하는 **푸시전용 앱** 사용자도 딥링크 기능을 통해 앱 실행 및 특정 페이지로 이동이 가능합니다.\
이 문서에서는 딥링크를 구현하는 방법과 주의할 점, 그리고 appId 확인 방법까지 자세히 안내드립니다.

***

## 딥링크 기본 구조

스윙투앱의 딥링크는 아래의 URL 포맷을 사용합니다.

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

* `{app_id}`는 해당 앱의 고유 ID입니다. (뒤에서 확인 방법 안내)
* 위 URL은 앱을 실행하지만 별도 실행 주소(URL)는 전달하지 않습니다.
* 앱이 설치되어 있지 않은 경우, 사용자의 디바이스에 따라 **Google Play스토어 또는 App Store**로 자동 연결됩니다.

***

## 딥링크로 실행 주소(URL) 함께 전달하기

앱을 실행하면서 특정 웹페이지로 이동시키고자 할 경우 `url` 파라미터를 함께 전달하면 됩니다.

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

### 참고

* `url` 파라미터는 **URL 인코딩(URL Encoding)** 이 필요합니다.
* 예시:\
  실제 적용 시에는 아래와 같이 인코딩된 형태로 전달해야 합니다.

```
인코딩 전:
https://m.naver.com

인코딩 후:
https%3A%2F%2Fm.naver.com
```

* URL 인코딩은 웹사이트, 자바스크립트 함수(`encodeURIComponent()`), 서버 코드 등에서 쉽게 처리할 수 있습니다.

***

## POST 방식도 지원합니다

딥링크 요청은 **GET 방식** 뿐만 아니라 **POST 방식**으로도 호출이 가능합니다.\
예를 들어, 보안 또는 URL 길이 제한 등의 이유로 POST로 호출하고자 하는 경우에도 대응할 수 있습니다.

***

## appId 확인 방법

앱의 `appId`는 **스윙투앱 푸시전용 앱**을 유료 결제한 사용자만 확인할 수 있습니다.

### 확인 경로:

```
앱운영 > 서비스 관리 > 앱운영관리 > 앱고급관리 > API-KEY 관리
```

* 해당 페이지에서 `appId`와 함께 API KEY 등의 정보를 확인하실 수 있습니다.
* 무료 사용자 또는 미결제 앱은 `appId`가 제공되지 않으며, 딥링크 기능을 사용할 수 없습니다.

***

## 딥링크 예제

아래는 실제 딥링크 사용 예제입니다.

### 앱 실행만 하는 경우 (설치 안 되어 있으면 앱스토어 이동)

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

### 앱 실행과 동시에 특정 페이지로 이동

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

***

## 유의사항

* 앱이 설치되지 않은 경우, 사용자의 기기 환경에 따라 스토어로 자동 이동합니다.
* 반드시 **스윙투앱 최신 버전(2025년 7월 14일 이후)으로 앱이 업데이트되어 있어야** 딥링크 기능이 정상 작동합니다.
* 푸시전용앱은 최소한의 기능만 지원되므로, WebView 페이지 내에서 링크 호출 시 기능 제한이 있을 수 있습니다.

***

## 마무리

스윙투앱의 푸시전용 앱도 간편한 딥링크 기능을 통해 다양한 알림 마케팅을 구현할 수 있습니다.\
웹페이지 연동, 특정 페이지 안내, 스토어 유도 등 다양한 용도로 활용해보세요.