API

도메인 수정

작성일 2026.03.20 | 수정일 2026.03.20

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

마이사이트 앱의 도메인 및 설정을 수정합니다.

Body Params

Name	Type	Description
domainPrefix	string	변경할 서브도메인 접두사. customDomain 중 하나는 필수
customDomain	string	변경할 커스텀 도메인. domainPrefix 중 하나는 필수
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
appName	string	*	앱 이름
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		슬로건 표시 여부
alwaysUseSubAccount	boolean		항상 서브계정 사용 여부
dateCreated	string	*	생성일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)

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",
  "appName": "내 마이사이트",
  "appDomain": "myshop.appstore.solapi.com",
  "customDomain": null,
  "CNAME": "d1234567890.cloudfront.net",
  "apphomeConfig": {
    "primaryColor": "#3B82F6",
    "secondaryColor": "#1E40AF",
    "sideMenu": true,
    "menuItemsVisibility": {
      "sideMenu": true,
      "headerMenu": true,
      "supportButton": true
    },
    "channelTalkPluginId": null,
    "slogan": true
  },
  "alwaysUseSubAccount": false,
  "dateCreated": "2024-01-15T09:00:00.000Z",
  "dateUpdated": "2024-03-20T14:30:00.000Z"
}