API

앱 목록 조회

작성일 2026.03.19 | 수정일 2026.03.20

GET/appstore/v2/apps

Query

offset— 페이지네이션 시작 위치(기본값: 0)

limit— 반환할 레코드 수(기본값: 20)

type — 앱 타입 (APP, SITE, ALL)

accountId— 계정 ID로 필터링

appId— 앱 ID로 필터링

appName— 앱 이름으로 검색 (대소문자 무시)

categories— 카테고리로 필터링

현재 활성화된 모든 앱 목록을 조회합니다.

Response

아래의 앱 객체를 포함한 배열을 반환합니다.

Name	Type	Required	Description
appId	string	*	앱 고유 ID (12자)
appName	string	*	앱 이름
appVersion	string\|null		앱 버전
accountId	string	*	앱 소유자 계정 ID
clientId	string	*	OAuth2 클라이언트 ID
thumbnail	object\|null	*	썸네일 이미지 정보
name	string\|null		이미지 파일명
url	string\|null		이미지 접근 URL
originalName	string\|null		원본 파일명
screenshots	array	*	스크린샷 이미지 목록
homepage	string\|null		홈페이지 URL
profit	object	*	메시지 타입별 수익금 (단위: 원)
sms	number		단문 문자 수익금
lms	number		장문 문자 수익금
mms	number		사진 문자 수익금
ata	number		알림톡 수익금
cta	number		친구톡 수익금
cti	number		친구톡 이미지 수익금
nsa	number		네이버 스마트 알림 수익금
rcs_sms	number		RCS 단문 수익금
rcs_lms	number		RCS 장문 수익금
rcs_mms	number		RCS 사진 수익금
rcs_tpl	number		RCS 템플릿 수익금
rcs_itpl	number		RCS 이미지 템플릿 수익금
rcs_ltpl	number		RCS LMS 템플릿 수익금
fax	number		팩스 수익금
voice	number		보이스콜 수익금
bms_text	number		비즈메시지 텍스트형 수익금
bms_image	number		비즈메시지 이미지형 수익금
bms_wide	number		비즈메시지 와이드형 수익금
bms_wide_item_list	number		비즈메시지 와이드 아이템 리스트형 수익금
bms_carousel_feed	number		비즈메시지 캐러셀 피드형 수익금
bms_premium_video	number		비즈메시지 프리미엄 비디오형 수익금
bms_commerce	number		비즈메시지 커머스형 수익금
bms_carousel_commerce	number		비즈메시지 캐러셀 커머스형 수익금
bms_free	number		비즈메시지 자유형 수익금
categories	array	*	앱 카테고리 목록
intro	string\|null		앱 소개 (한 줄)
description	string\|null		앱 상세 설명
stage	string	*	앱 스테이지 (DEVELOP, LIVE)
status	string	*	앱 상태 (ACTIVE, BLOCKED, INACTIVE)
email	string\|null		연락처 이메일
type	string	*	앱 타입 (APP, SITE)
deductFromMaster	boolean	*	마스터 잔액 차감 모드
ssoAllowedIp	array	*	SSO 허용 IP 목록
allowIframe	boolean	*	iframe 임베딩 허용 여부
customerCenterNumber	string\|null		고객센터 전화번호
alwaysUseSubAccount	boolean	*	항상 서브계정 사용 여부
appDomain	string\|null		앱 도메인
customDomain	string\|null		커스텀 도메인
apphomeConfig	object	*	앱홈 설정
primaryColor	string\|null		기본 색상
secondaryColor	string\|null		보조 색상
sideMenu	boolean		사이드 메뉴 표시 여부
menuItemsVisibility	object		메뉴 항목 표시 설정
sideMenu	boolean		사이드 메뉴 표시 여부
headerMenu	boolean		헤더 메뉴 표시 여부
supportButton	boolean		고객지원 버튼 표시 여부
channelTalkPluginId	string\|null		채널톡 플러그인 ID
slogan	boolean		슬로건 표시 여부
redirectUri	string		OAuth2 리다이렉트 URI
scope	string		OAuth2 스코프
dateCreated	string	*	생성일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)

Structure

Response

[
  {
    "appId": "aBcDeFgHiJkL",
    "appName": "메시지 발송 도우미",
    "appVersion": null,
    "accountId": "12345678901234",
    "clientId": "COID_abcdefghijkl",
    "thumbnail": {
      "name": "thumbnail.png",
      "url": "https://s3.ap-northeast-2.amazonaws.com/appstore/thumbnail.png",
      "originalName": "my-thumbnail.png"
    },
    "screenshots": [
      {
        "name": "screenshot1.png",
        "url": "https://s3.ap-northeast-2.amazonaws.com/appstore/screenshot1.png",
        "originalName": "app-preview.png"
      }
    ],
    "homepage": "https://example.com",
    "profit": {
      "sms": 2,
      "lms": 5,
      "mms": 10,
      "ata": 3,
      "cta": 8,
      "cti": 0,
      "nsa": 0,
      "rcs_sms": 0,
      "rcs_lms": 0,
      "rcs_mms": 0,
      "rcs_tpl": 0,
      "rcs_itpl": 0,
      "rcs_ltpl": 0,
      "fax": 0,
      "voice": 0,
      "bms_text": 0,
      "bms_image": 0,
      "bms_wide": 0,
      "bms_wide_item_list": 0,
      "bms_carousel_feed": 0,
      "bms_premium_video": 0,
      "bms_commerce": 0,
      "bms_carousel_commerce": 0,
      "bms_free": 0
    },
    "categories": [
      "메시징",
      "마케팅"
    ],
    "intro": "간편하게 메시지를 발송하세요",
    "description": "솔라피 API를 활용한 대량 메시지 발송 서비스입니다.",
    "stage": "LIVE",
    "status": "ACTIVE",
    "email": "contact@example.com",
    "type": "APP",
    "deductFromMaster": false,
    "ssoAllowedIp": [],
    "allowIframe": false,
    "customerCenterNumber": null,
    "alwaysUseSubAccount": false,
    "appDomain": null,
    "customDomain": null,
    "apphomeConfig": {
      "primaryColor": null,
      "secondaryColor": null,
      "sideMenu": true,
      "menuItemsVisibility": {
        "sideMenu": true,
        "headerMenu": true,
        "supportButton": true
      },
      "channelTalkPluginId": null,
      "slogan": true
    },
    "redirectUri": "https://example.com/callback",
    "scope": "users:read",
    "dateCreated": "2024-01-15T09:00:00.000Z",
    "dateUpdated": "2024-03-20T14:30:00.000Z"
  }
]