App 생성 및 기본설정안내

  • 카페24 개발자센터를 통해 App을 등록하고 기본적인 관리를 할 수 있는 가이드입니다.

App 관리

  • 개발자센터에 로그인하면 App을 생성/관리할 수 있는 관리화면이 노출됩니다.
  • [1] : 신규 App을 추가 생성할 수 있습니다.
  • [2] : 등록한 App이 노출되며, 기본적인 App의 상태를 확인할 수 있습니다.

1. App 신규 등록

  • [1] : App 이름
    App의 이름을 입력합니다. 입력되는 App의 이름은 내부 관리용으로
    사용되며 실제 App Store에 판매되는 이름은 아닙니다.
  • [2] : App URL
    App을 서비스하거나 홍보할 수 있는 기본 서비스 URL을 입력합니다.
    App의 서비스는 https:// 형태의 SSL 인증 URL을 입력해야 원활한 서비스가 가능합니다.
    서비스되는 포트(Port)의 지정이 필요한 경우 함께 입력할 수 있습니다.
  • [3] : App 유형
    제작 및 서비스되는 App의 유형을 선택할 수 있습니다.
    선택된 App의 유형은 API Key 발급시 참고되어 사용되며 추후 변경이 불가능합니다.
    일반적으로 네이티브(Native) App 형태가 아닌 경우 Web Application을 선택하시면 됩니다.

2. 등록된 App의 표시 및 상태

  • [1] : App이 생성된 일자가 표시됩니다.
  • [2] : App의 대표 아이콘이 표시됩니다.
    아이콘을 미등록하시면 Blank 이미지가 표시됩니다.
  • [3] : App 이름이 표시됩니다.
    표시되는 App의 이름은 App Store용 이름이 아닌 관리용 App 이름이 표시됩니다.
  • [4] : App의 상태가 표시됩니다.
    App의 상태는 '제작중', '심사중', '심사반려', '판매중', '판매종료' 상태가 표시됩니다.
    App이 심사과정에서 반려된 경우 [6]번의 이미지가 추가적으로 노출됩니다.
    App이 '판매중'인 경우 App의 임의삭제는 불가능하며, 삭제를 원하시는 경우 카페24에 문의하면 처리가 가능합니다.
  • [5] : 심사반려 사유가 표시됩니다.
    App이 심사반려된 경우 아이콘을 클릭하시면 심사반려사유를 확인하실 수 있습니다.

App 기본정보등록

  • 개발자센터에서 생성한 App을 클릭하면 App의 기본정보를 등록하고 관리할 수 있는 화면이 노출됩니다.

1. App 기본정보등록 > 기본정보

  • [1] : App 이름을 수정할 수 있습니다.
    App이 최초 생성시 입력한 App 이름이 기본적으로 노출됩니다. 사용자의 필요에 따라 App 이름을 수정하며 관리할 수 있습니다.
    이곳에 등록되는 이름은 관리를 위한 이름이며, App Store에 노출되는 이름은 아닙니다.
     
  • [2] : App URL을 수정할 수 있습니다.
    App이 최초 생성시 입력한 App URL이 기본적으로 노출됩니다. 사용자의 필요에 따라 App URL을 수정할 수 있습니다.
    App이 판매중이거나 서비스 중인경우 App URL을 수정하시면 서비스가 안될 수 있으니 주의해야 합니다.
     
  • [3] : Redirect URL(s)입력하거나 수정할 수 있습니다.
    App이 인증 후 redirect_uri 로 전달될 URL을 입력할 수 있습니다.
    URL의 구분은 엔터(enter)로 구분하여 입력합니다. (최대 10개 / 200byte 이내)
    보안정책 기준으로 https를 반드시 사용해야 합니다. (http는 지원되지 않습니다.)
    서브 도메인이 있으면 대표 도메인명만 입력해 주세요. (예: https://cafe24.com)
     
  • [4] : App 대표 아이콘
    App Store나 쇼핑몰 플랫폼에서 App을 쉽게 구분하기 위해 대표아이콘을 등록할 수 있습니다.
    App 대표아이콘은 사용자들이 App을 구분할 수 있고 홍보하는데 도움이 됩니다.
    권장(등록) 이미지: 120px * 120px / 50KB이하 / png, jpg(jpeg)

2. App 기본정보등록 > 사용권한정보

  • [1] : API 사용권한을 추가하거나 삭제할 수 있습니다.
    App이 사용할 API의 사용권한을 추가하거나 삭제할 수 있습니다. API를 사용하기 위해서는 반드시 사용권한이 등록되어 있어야 합니다.
    권한을 선택하면 쇼핑몰에서 App 설치시 동의를 받게되며 동의한 경우 API가 정상 호출됩니다.
    권한이 없는 API를 호출하는 경우 404 (권한이 허용되지 않음) 오류가 반환되며 API 결과값을 얻을 수 없습니다.
     
  • 권한의 분류 및 적용범위는 아래와 같습니다.
권한구분 상세
분류 적용범위
상품분류
(Categories)
상품분류(Categories), 메인진열(Mains), 기획전(Projects) 정보
상품
(Product)
상품(Products) 정보
판매분류
(Collection)
브랜드(Brands), 자체분류(CustomCollection), 제조사(Manufacturers), 트렌드(Trends) 정보
공급사
(Supply)
공급사(Suppliers), 공급사 운영자(Suppliers/Users) 정보
개인화정보
(Personal)
좋아요(Likes), 관심상품(Wishes), 장바구니(Cart) 정보
주문
(Order)
주문(Orders) 정보
게시판
(Community)
리뷰톡톡(Reviews), 덧글(Comments) 정보
회원
(Customer)
회원(Customers),회원등급(CustomerGroup),적립금(Mileage),
예치금(Deposit), 배송주소록(CustomerAddress) 정보
알림
(Notification)
메일(Mail), 메시지(Message) 정보
상점
(Store)
상점(Store) 정보
프로모션
(Promotion)
고객혜택(Benefits), 쿠폰(Coupons), 시리얼쿠폰(SerialCoupons) 정보
디자인
(Design)
디자인(Themes), 화면(Pages) 정보

(Application)
앱(Application) 설치와 관련된 정보
매출통계
(SalesReport)
매출 통계(SalesReport)와 관련된 정보
  • 자세한 권한을 이용한 보안/인증 및 API 호출 방법은 인증/보안가이드, API 가이드 또는 API Support Tool 가이드를 참고하여 주시기 바랍니다.

  • [2] : App의 실행시 쇼핑몰의 부운영자, 공급사운영자의 권한의 설정이 필요한 경우 App의 화면목록과 동작권한목록을 확인할 수 있는 URL을 입력하거나 수정할 수 있습니다.
    쇼핑몰 운영자의 권한 확인 및 운영자 권한에 따른 App 내에서의 제어가 필요한 경우 운영자권한 개발가이드를 참고하여 주시기 바랍니다.

3. App 기본정보등록 > 인증정보

  • [1] : App 유형을 확인할 수 있습니다.
    App이 최초 생성시 선택한 App 유형이 노출됩니다. App 유형은 API Key 인증과 관련이 있는 범위이므로 변경이 불가능합니다.
     
  • [2] : App Key를 확인하고 복사할 수 있습니다.
    API를 사용하기 위해 필요한 기본적인 2개의 키(key) 값 중 하나입니다. 일반적으로 App Key는 OAuth의 기준에서 Client ID와 동일한 값이며, 쇼핑몰의 로그인 기준에서는 아이디에 해당하는 값입니다.
     
  • [3] : App Secret Key를 확인하고 복사하고 재발급할 수 있습니다.
    API를 사용하기 위해 필요한 기본적인 2개의 키(key) 값 중 하나입니다. 일반적으로 App Secret Key는 OAuth의 기준에서 Client Secret과 동일한 값이며 비밀번호에 해당하는 값입니다.
    App key와 더불어 App secret key가 유출되거나 노출되는 경우 App의 보안이 매우 취약해 질 수 있습니다.
    의심이 갈만한 정황이 포착된 경우 반드시 App secret key를 재발급 받아 갱신할 것을 권장합니다.
    단, App secret key를 재발급 받는 경우 App에 대한 사용동의를 다시 받아야 정상적인 사용이 가능합니다. 반드시 꼭 필요하다고 생각될 때 재발급 받으셔야 합니다.
    서비스 중 불가피하지 않은 사유로 인해 재발급을 받으신 경우 서비스가 중단되거나 App이 정상적으로 동작하지 않을 수 있습니다.