APP 설치 연동 가이드

📘 개발 가이드

APP 설치 연동 가이드

스토어에서 상점이 APP을 설치할 때, 파트너사에서 처리해야 하는 연동 절차를 설명합니다.

개요

상점이 APP 설치를 완료하면 다음 두 단계로 연동이 진행됩니다.

1

APP URL로 랜딩

설치 완료 시 APP URL로 랜딩되며, shop_uid가 GET 파라미터로 전달됩니다.

2

설치 정보 조회 및 온보딩

전달받은 shop_uid를 이용해 상점 설치 앱 정보 조회 API를 호출하여 설치 정보를 조회하고 온보딩을 진행합니다.

1. APP 설치 완료 후 동작

설치하기와 신청하기 두 가지 액션 모두 동일하게 동작합니다. 설치가 완료되면, 등록된 APP URL로 자동으로 랜딩되며, 이때 shop_uid가 GET 파라미터로 함께 전달됩니다.

https://your-app-url.com?shop_uid={shop_uid}

💡

APP URL 확인 경로

개발자센터 > APP 가이드 > APP 등록 > 개발 정보 관리 > APP URL 항목

2. 상점 설치 앱 정보 조회 API

설치된 APP의 상세 정보를 조회할 수 있는 API를 제공합니다. 온보딩 처리에 필요한 설치 정보 및 만료일 등을 확인할 수 있습니다.

요청

항목	내용
Method	GET
URL	/api/application/:shopId/apps

Path Parameters

Parameter	Required	Description
shopId	필수	요청한 상점 ID

Query Parameters

Parameter	Required	Description
client_id	필수	조회하고자 하는 APP의 Client ID

⚠️

주의

Access Token 발급 시 사용한 client_id와 shopId를 동일하게 입력해야 합니다. 다른 값을 입력할 경우 올바른 설치 정보를 조회할 수 없습니다.

Curl 예시

curl -X GET 'https://connect.makeshop.co.kr/api/application/{shopId}/apps?client_id={client_id}' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <token>'

응답 예시

HTTP/1.1 200 OK
{
  "success": true,
  "operation": "store_application_apps.get_installed_app",
  "code": "OK",
  "message": "",
  "data": {
    "shop_uid": "makeshop",
    "client_id": "abcedfg-hijklmn-opqrstu-vwxyz",
    "app_name": "APP 테스트2",
    "app_url": "https://store.makeshop.co.kr",
    "installed_at": "2026-04-16",
    "expired_at": "2026-05-01"
  }
}

응답 필드 설명

Field Name	Description	비고
shop_uid	상점 ID	해당 APP을 설치한 상점의 메이크샵 고유 UID
client_id	클라이언트 ID	APP 등록 시 발급된 클라이언트 ID
app_name	APP 이름	APP의 관리용 상품명
app_url	APP URL	APP 설치 시 랜딩할 URL
installed_at	설치일	APP 설치 일자 YYYY-MM-DD
expired_at	만료일	APP 설치 만료일 YYYY-MM-DD