Saleor App Manifest 스펙

manifest.json 필드

필드필수설명
idO앱 고유 식별자 (URL 형식 권장)
nameO앱 이름 (Dashboard 표시)
versionO앱 버전
about-앱 설명
permissions-요청 권한 목록 (기본 [])
appUrl-Dashboard iframe URL
tokenTargetUrl-설치 토큰 수신 URL
requiredSaleorVersion-semver range (예: >=3.10 <4)
author-제작자 (max 60자)
brand-로고 이미지 URL
extensions-Dashboard UI 확장 포인트
webhooks-Webhook 정의 배열

요청 가능 Permission 전체

MANAGE_USERS, MANAGE_STAFF, IMPERSONATE_USER
MANAGE_APPS, MANAGE_OBSERVABILITY, MANAGE_CHANNELS
MANAGE_CHECKOUTS, HANDLE_CHECKOUTS, HANDLE_TAXES, MANAGE_TAXES
MANAGE_DISCOUNTS, MANAGE_GIFT_CARD, MANAGE_MENUS
MANAGE_ORDERS, MANAGE_ORDERS_IMPORT
MANAGE_PAGES, MANAGE_PAGE_TYPES_AND_ATTRIBUTES
HANDLE_PAYMENTS, MANAGE_PLUGINS
MANAGE_PRODUCTS, MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES
MANAGE_SHIPPING, MANAGE_SETTINGS, MANAGE_TRANSLATIONS

Webhook 정의 구조

{
  "name": "Order webhook",
  "targetUrl": "https://example.com/webhook",
  "query": "subscription { event { ... on OrderCreated { order { id } } } }",
  "asyncEvents": ["ORDER_CREATED"],
  "syncEvents": ["CHECKOUT_CALCULATE_TAXES"]
}

targetUrlhttp/https/awssqs/gcpubsub 프로토콜 지원.

관련: Saleor App 한계와 제약, Saleor Dashboard Extension 포인트