API

도메인 생성

작성일 2026.03.20 | 수정일 2026.03.20

POST/appstore/v2/me/apps/:appId/apphome

Parameters

appId— 대상 앱 ID

마이사이트 앱에 도메인을 생성합니다. 도메인이 없는 앱에서만 사용 가능합니다.

Body Params

Name	Type	Required	Description
domainPrefix	string	*	서브도메인 접두사 (예: 'myshop' → myshop.appstore.solapi.com)
customDomain	string		커스텀 도메인 (예: 'shop.example.com')
primaryColor	string		기본 테마 색상
secondaryColor	string		보조 테마 색상
sideMenu	boolean		사이드 메뉴 표시 여부
headerMenu	boolean		헤더 메뉴 표시 여부
supportButton	boolean		고객지원 버튼 표시 여부
channelTalkPluginId	string		채널톡 플러그인 ID
slogan	boolean		슬로건 표시 여부
alwaysUseSubAccount	boolean		항상 서브계정 사용 여부

Response

Name	Type	Required	Description
appId	string	*	앱 ID
appDomain	string	*	생성된 앱홈 도메인 (예: myshop.appstore.solapi.com)
customDomain	string\|null		커스텀 도메인
CNAME	string	*	커스텀 도메인 사용 시 DNS에 설정할 CNAME 값
apphomeConfig	object	*	앱홈 설정
primaryColor	string\|null		기본 테마 색상
secondaryColor	string\|null		보조 테마 색상
sideMenu	boolean		사이드 메뉴 표시 여부
menuItemsVisibility	object		메뉴 표시 설정
sideMenu	boolean		사이드 메뉴 표시 여부
headerMenu	boolean		헤더 메뉴 표시 여부
supportButton	boolean		고객지원 버튼 표시 여부
channelTalkPluginId	string\|null		채널톡 플러그인 ID
slogan	boolean		슬로건 표시 여부

Structure

Request

{
  "domainPrefix": "myshop",
  "customDomain": "shop.example.com",
  "primaryColor": "#3B82F6",
  "secondaryColor": "#1E40AF",
  "sideMenu": true,
  "headerMenu": true,
  "supportButton": true,
  "channelTalkPluginId": "ch-plugin-123",
  "slogan": true,
  "alwaysUseSubAccount": false
}

Response

{
  "appId": "aBcDeFgHiJkL",
  "appDomain": "myshop.appstore.solapi.com",
  "customDomain": "shop.example.com",
  "CNAME": "d1234567890.cloudfront.net",
  "apphomeConfig": {
    "primaryColor": "#3B82F6",
    "secondaryColor": "#1E40AF",
    "sideMenu": true,
    "menuItemsVisibility": {
      "sideMenu": true,
      "headerMenu": true,
      "supportButton": true
    },
    "channelTalkPluginId": "ch-plugin-123",
    "slogan": true
  }
}