feat(performance): 실적(쇼핑몰 통합 매출) 모듈 1단계 — 대시보드·설정·보안·어댑터 구조

- 네 영역 분리: ① 수집(adapters/ 쇼핑몰 10곳 + sync.py) ② 보안(security/ + credentials.py)
  ③ 계산·저장(calc.py + db.py) ④ 화면(dashboard.py, router.py, templates, performance.css/js)
- 대시보드: 기간(오늘/이번주/이번달/올해/직접선택, 이전·다음), 쇼핑몰 필터, KPI 5개(진행 중 기간은
  직전 기간 같은 경과일 대비), 일자×쇼핑몰 표(주간합계, 총매출/수수료/차감매출 전환), 일별 추이·
  쇼핑몰 비중(SVG), 월 누적(비중)·연간 누적, 금액 클릭 → 주문 상세
- 설정(관리자): 사용/매출 집계, 수수료율 이력(적용 시작일), 쇼핑몰별 API 인증정보 입력·연결 테스트·
  연결 상태, 마스터 키 상태·재암호화, 테스트(모의) 데이터 생성/삭제
- 인증정보: 설정 화면 입력 → AES-256-GCM(키 버전, AAD=쇼핑몰+항목) 암호화 저장, secret 원문은
  화면으로 다시 보내지 않음, 오류·로그·raw 는 비밀값 가린 뒤 저장. 마스터 키는 APP_ENCRYPTION_KEY(.env)
- 매출 기준일: 결제=결제일, 취소·반품=발생일. 금액 원 단위 정수, 수수료 반올림은 calc.commission 한 곳
- 동기화: 같은 쇼핑몰 동시 실행 차단(running 부분 유니크), 쇼핑몰별 실패 격리, 중복 방지 UNIQUE+UPSERT
- 카페24 어댑터는 기존 app/integrations/cafe24 OAuth 토큰 재사용, 나머지는 입력칸만(수집은 다음 단계)
- performance_db 초기화 스크립트, 권한키 performance(설정은 is_admin), 문서·.env.example

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-29 16:07:46 +09:00
parent b95206dcf4
commit aa669553db
41 changed files with 4326 additions and 1 deletions
@@ -0,0 +1,5 @@
"""① 쇼핑몰 API 수집 — 쇼핑몰별 어댑터(공통 인터페이스는 base.py, 목록은 registry.py)."""
from .registry import all_adapters, get_adapter
__all__ = ["all_adapters", "get_adapter"]
+215
View File
@@ -0,0 +1,215 @@
"""① 쇼핑몰 API 수집 — 공통 인터페이스.
쇼핑몰 하나 = 어댑터 파일 하나. 새 쇼핑몰은 `MarketplaceAdapter` 를 상속한 파일을
만들고 `registry.py` 에 한 줄 추가하면 설정 화면·동기화·대시보드에 자동으로 붙는다.
흐름: 쇼핑몰 원본 → 어댑터(fetch_* → normalize_*) → 공통 SaleEvent → sync 서비스가 DB 저장
어댑터가 지켜야 할 것:
- 인증정보는 `ctx.credentials.get(key)` 로만 꺼낸다(복호화는 서버 안에서만).
- 새 토큰은 `ctx.credentials.set(key, value)` 로 저장한다(자동 암호화).
- 오류는 아래 AdapterError 계열로 던진다. 메시지에 비밀값을 넣지 않는다
(sync 서비스가 한 번 더 가리지만, 애초에 넣지 않는 것이 원칙).
- 금액은 원 단위 정수(int). 결제는 +, 취소/반품은 − 로 만든다.
- 날짜 기준을 섞지 않는다: order_date / payment_date / event_date 를 각각 채운다.
집계 기준일(sales_date)은 sync 서비스가 정한다(결제=결제일, 취소·반품=발생일).
"""
from __future__ import annotations
from abc import ABC
from dataclasses import dataclass, field
from datetime import date
from typing import Any, Iterable, Protocol
# 연결 상태 코드 → 화면 표시. DB CHECK 제약과 같은 목록.
STATUS_LABELS: dict[str, str] = {
"ok": "정상 연결",
"not_configured": "인증정보 미설정",
"auth_failed": "인증 실패",
"token_expired": "Token 만료",
"api_error": "API 오류",
"not_implemented": "연동 준비 중",
"unknown": "확인 전",
"disabled": "사용 중지", # DB 에는 저장하지 않는 화면 전용 상태(쇼핑몰 사용 OFF)
}
EVENT_TYPES = ("SALE", "CANCEL", "RETURN", "ADJUST")
# ════════════════════════════════════════════════════════════
# 오류 — status 가 곧 연결 상태 코드
# ════════════════════════════════════════════════════════════
class AdapterError(Exception):
status = "api_error"
def __init__(self, message: str = "") -> None:
super().__init__(message or STATUS_LABELS.get(self.status, "오류"))
self.message = message or STATUS_LABELS.get(self.status, "오류")
class NotConfigured(AdapterError):
status = "not_configured"
class AuthFailed(AdapterError):
status = "auth_failed"
class TokenExpired(AdapterError):
status = "token_expired"
class ApiError(AdapterError):
status = "api_error"
class NotImplementedYet(AdapterError):
status = "not_implemented"
# ════════════════════════════════════════════════════════════
# 설정 입력칸 · 공통 매출 사건
# ════════════════════════════════════════════════════════════
@dataclass(frozen=True)
class CredentialField:
"""설정 화면 입력칸 하나. secret=True 면 저장 후 값을 화면으로 다시 보내지 않는다.
internal=True 는 화면에 안 보이는 내부 값(access/refresh token 등) — 어댑터가 직접 저장.
"""
key: str
label: str
secret: bool = False
required: bool = True
help: str = ""
placeholder: str = ""
internal: bool = False
@dataclass
class SaleEvent:
"""쇼핑몰 원본을 공통 형식으로 바꾼 매출 사건 하나(주문 라인 단위 권장)."""
event_type: str # SALE / CANCEL / RETURN / ADJUST
external_event_id: str # 쇼핑몰 안에서 이 사건을 유일하게 가리키는 값(중복 방지 키)
external_order_id: str
event_date: date # 사건 발생일(결제=결제일, 취소=취소일, 반품=반품완료일)
amount: int # 원 단위 정수. 결제 +, 취소/반품 −
external_line_id: str = ""
order_date: date | None = None
payment_date: date | None = None
product_name: str = ""
option_name: str = ""
quantity: int = 0
discount_amount: int = 0
order_status: str = ""
raw: dict[str, Any] = field(default_factory=dict)
def validate(self) -> None:
if self.event_type not in EVENT_TYPES:
raise ValueError(f"알 수 없는 사건 종류: {self.event_type}")
if not self.external_event_id or not self.external_order_id:
raise ValueError("external_event_id / external_order_id 가 필요합니다.")
if not isinstance(self.amount, int) or isinstance(self.amount, bool):
raise ValueError("amount 는 원 단위 정수여야 합니다.")
if self.event_type == "SALE" and self.amount < 0:
raise ValueError("결제(SALE) 금액은 음수일 수 없습니다.")
if self.event_type in ("CANCEL", "RETURN") and self.amount > 0:
raise ValueError("취소/반품 금액은 음수(또는 0)여야 합니다.")
class CredentialAccessor(Protocol):
def get(self, key: str) -> str: ...
def set(self, key: str, value: str) -> None: ...
def has(self, key: str) -> bool: ...
@dataclass
class AdapterContext:
code: str
credentials: CredentialAccessor
app_state: Any = None # 공통 연동 계층 재사용(예: 카페24 토큰 저장소)
timeout_sec: float = 20.0
# ════════════════════════════════════════════════════════════
# 어댑터
# ════════════════════════════════════════════════════════════
class MarketplaceAdapter(ABC):
code: str = ""
name: str = ""
auth_type: str = "api_key" # api_key / oauth / shared(공통 연동 계층 재사용)
docs_url: str = ""
implemented: bool = False # 실제 수집(fetch)이 구현됐는가
note: str = "" # 설정 화면 안내 문구
# ── 설정 ──────────────────────────────────────────────
def credential_fields(self) -> list[CredentialField]:
return []
def visible_fields(self) -> list[CredentialField]:
return [f for f in self.credential_fields() if not f.internal]
@property
def uses_shared_integration(self) -> bool:
return self.auth_type == "shared"
def validate_credentials(self, values: dict[str, str]) -> list[str]:
"""저장 전 검사. 값 자체를 오류 문구에 넣지 않는다."""
errors: list[str] = []
for f in self.visible_fields():
v = (values.get(f.key) or "").strip()
if f.required and not v:
errors.append(f"{f.label} 을(를) 입력하세요.")
elif v and len(v) > 2000:
errors.append(f"{f.label} 값이 너무 깁니다.")
return errors
def is_configured(self, ctx: AdapterContext) -> bool:
return all(ctx.credentials.has(f.key) for f in self.visible_fields() if f.required)
# ── 인증 ──────────────────────────────────────────────
def authenticate(self, ctx: AdapterContext) -> None:
"""API 호출 전 준비(토큰 발급 등). 기본은 할 일 없음."""
if not self.is_configured(ctx):
raise NotConfigured("필수 인증정보가 입력되지 않았습니다.")
def refresh_token(self, ctx: AdapterContext) -> None:
"""OAuth 쇼핑몰: refresh token 으로 access token 재발급 후 ctx.credentials.set(...)."""
return None
def test_connection(self, ctx: AdapterContext) -> str:
"""성공 시 사람이 읽을 짧은 문구 반환. 실패는 AdapterError."""
self.authenticate(ctx)
raise NotImplementedYet(f"{self.name} API 연동은 다음 단계에서 구현됩니다.")
# ── 수집 ──────────────────────────────────────────────
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
raise NotImplementedYet(f"{self.name} 주문 수집은 다음 단계에서 구현됩니다.")
def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
return []
def normalize_order(self, raw: dict[str, Any]) -> list[SaleEvent]:
raise NotImplementedYet(f"{self.name} 주문 변환은 다음 단계에서 구현됩니다.")
def normalize_refund(self, raw: dict[str, Any]) -> list[SaleEvent]:
return []
def collect(self, ctx: AdapterContext, start: date, end: date) -> tuple[int, list[SaleEvent]]:
"""기간의 주문·취소/반품을 받아 공통 사건으로 변환. (원본 건수, 사건 목록)."""
self.authenticate(ctx)
fetched = 0
events: list[SaleEvent] = []
for raw in self.fetch_orders(ctx, start, end):
fetched += 1
events.extend(self.normalize_order(raw))
for raw in self.fetch_refunds(ctx, start, end):
fetched += 1
events.extend(self.normalize_refund(raw))
for ev in events:
ev.validate()
return fetched, events
@@ -0,0 +1,49 @@
"""카페24 — 공통 연동 계층(app/integrations/cafe24) 재사용.
카페24는 이미 OAuth 로 연결해 쓰고 있다(상품관리). 실적 설정에서 인증정보를 따로
받지 않고, 같은 토큰 저장소(cafe24_db)의 연결 상태를 그대로 보여 준다.
주문 수집(다음 단계)에는 카페24 앱 권한에 mall.read_order 추가 + 재연결이 필요하다
(app/integrations/cafe24/config.py 의 ORDER_SCOPES).
"""
from __future__ import annotations
from .base import AdapterContext, AuthFailed, MarketplaceAdapter, NotConfigured, TokenExpired
class Cafe24Adapter(MarketplaceAdapter):
code = "cafe24"
name = "카페24"
auth_type = "shared"
docs_url = "https://developers.cafe24.com/docs/api/admin/"
note = "카페24 상품관리에서 연결한 OAuth 토큰을 함께 씁니다(여기서 따로 입력하지 않음)."
def is_configured(self, ctx: AdapterContext) -> bool:
return True
def authenticate(self, ctx: AdapterContext) -> None:
st = self.shared_status(ctx)
if not st.get("connected"):
if st.get("missing"):
raise NotConfigured("카페24 연동 환경변수가 설정되지 않았습니다.")
if st.get("needs_reauth") and st.get("reason", "").startswith("refresh"):
raise TokenExpired("카페24 연결이 만료되었습니다. 카페24 상품관리 → 시스템에서 재연결하세요.")
raise AuthFailed("카페24에 연결되어 있지 않습니다. 카페24 상품관리 → 시스템에서 연결하세요.")
def shared_status(self, ctx: AdapterContext) -> dict:
from app.integrations.cafe24.config import load_config # 지연 import
from app.integrations.cafe24.tokens import TokenService # 지연 import
repo = getattr(ctx.app_state, "cafe24_store", None) if ctx.app_state is not None else None
config = load_config()
if repo is None:
return {"connected": False, "missing": config.missing or ["CAFE24_DB_URL"], "needs_reauth": False}
return TokenService(repo, config).status()
def test_connection(self, ctx: AdapterContext) -> str:
self.authenticate(ctx)
st = self.shared_status(ctx)
scopes = st.get("scopes") or ""
if "mall.read_order" not in scopes:
return "카페24 연결 정상. 주문 수집에는 주문 읽기 권한(mall.read_order) 추가가 필요합니다."
return "카페24 연결 정상."
@@ -0,0 +1,24 @@
"""쿠팡 — 쿠팡 윙(마켓플레이스) Open API.
인증: Vendor ID + Access Key + Secret Key 로 요청마다 HMAC 서명(CEA 헤더).
로켓(공급) 매출은 기존 쿠팡 밀크런 모듈의 cupang_sales 에 있다 — 필요 시 별도 연계.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class CoupangAdapter(MarketplaceAdapter):
code = "coupang"
name = "쿠팡"
auth_type = "api_key"
docs_url = "https://developers.coupangcorp.com/"
note = "쿠팡 윙 → 판매자정보 → 추가판매정보 → OPEN API 키 발급에서 확인합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("vendor_id", "Vendor ID(업체코드)", placeholder="A00012345"),
CredentialField("access_key", "Access Key", secret=True),
CredentialField("secret_key", "Secret Key", secret=True),
]
@@ -0,0 +1,21 @@
"""11번가 — 11번가 셀러 오픈API.
인증: 셀러오피스에서 발급한 Open API Key 를 요청 헤더(openapikey)에 넣는다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class ElevenstAdapter(MarketplaceAdapter):
code = "elevenst"
name = "11번가"
auth_type = "api_key"
docs_url = "https://openapi.11st.co.kr/"
note = "11번가 셀러오피스 → 오픈API 에서 발급한 키를 입력합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("api_key", "Open API Key", secret=True),
]
@@ -0,0 +1,23 @@
"""G마켓 — ESM(ESM Plus / ESM Trading API).
인증: ESM 마스터 ID + 판매자 ID + 발급 Secret Key 로 JWT 서명(연동 단계에서 확정).
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class GmarketAdapter(MarketplaceAdapter):
code = "gmarket"
name = "G마켓"
auth_type = "api_key"
docs_url = "https://etapi.gmarket.com/"
note = "ESM Plus 에서 발급한 API 인증정보를 입력합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("master_id", "ESM 마스터 ID"),
CredentialField("seller_id", "G마켓 판매자 ID"),
CredentialField("secret_key", "Secret Key", secret=True),
]
@@ -0,0 +1,21 @@
"""GS샵 — 협력사 API.
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class GsshopAdapter(MarketplaceAdapter):
code = "gsshop"
name = "GS샵"
auth_type = "api_key"
note = "입력 항목은 연동 단계에서 GS샵 협력사 API 문서로 확정합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("vendor_code", "협력사 코드"),
CredentialField("api_key", "API Key", secret=True),
]
+21
View File
@@ -0,0 +1,21 @@
"""카카오 — 카카오쇼핑(톡스토어) 판매자 API.
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class KakaoAdapter(MarketplaceAdapter):
code = "kakao"
name = "카카오"
auth_type = "api_key"
note = "입력 항목은 연동 단계에서 카카오쇼핑 판매자 API 문서로 확정합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("seller_id", "판매자(채널) ID"),
CredentialField("api_key", "API Key", secret=True),
]
@@ -0,0 +1,21 @@
"""롯데ON — 롯데ON 판매자 API.
인증: 거래처번호 + 발급 API Key(연동 단계에서 확정).
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class LotteonAdapter(MarketplaceAdapter):
code = "lotteon"
name = "롯데ON"
auth_type = "api_key"
note = "롯데ON 스토어센터에서 발급한 API 인증정보를 입력합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("trade_no", "거래처번호"),
CredentialField("api_key", "API Key", secret=True),
]
+63
View File
@@ -0,0 +1,63 @@
"""테스트(모의) 매출 데이터 — 실제 API 연동 전 화면 확인용.
같은 (쇼핑몰, 날짜)면 항상 같은 값이 나온다(재현 가능). 결제뿐 아니라 전체 취소·
부분 반품도 섞어 넣어 음수 반영과 합계를 확인할 수 있게 한다.
DB 에는 is_sample=TRUE 로 들어가며 설정 화면에서 한 번에 지울 수 있다.
"""
from __future__ import annotations
import random
from datetime import date, timedelta
from .base import SaleEvent
# 쇼핑몰별 하루 평균 주문 건수(모의값) — 화면에 차이가 보이도록만 다르게 둔다.
_DAILY_ORDERS = {
"cafe24": 9, "naver": 14, "coupang": 18, "ohouse": 4, "gmarket": 6,
"kakao": 3, "gsshop": 2, "elevenst": 4, "lotteon": 2, "toss": 1,
}
_PRODUCTS = (
("스테인리스 냄비 20cm", 39_000), ("프라이팬 28cm", 45_900), ("밀폐용기 5종 세트", 29_800),
("도마 대형", 19_900), ("칼 블록 세트", 89_000), ("주방 가위", 12_900),
("냄비 받침", 8_900), ("전골 냄비", 59_000),
)
def generate(code: str, start: date, end: date) -> list[SaleEvent]:
events: list[SaleEvent] = []
base = _DAILY_ORDERS.get(code, 3)
d = start
while d <= end:
rng = random.Random(f"perf-sample:{code}:{d.isoformat()}")
weekend = d.weekday() >= 5
n = max(0, int(rng.gauss(base * (0.7 if weekend else 1.0), base * 0.35)))
for i in range(n):
name, price = rng.choice(_PRODUCTS)
qty = 1 if rng.random() < 0.8 else rng.randint(2, 3)
discount = rng.choice((0, 0, 0, 1000, 2000, 3000))
amount = max(0, price * qty - discount)
order_id = f"SAMPLE-{code}-{d:%Y%m%d}-{i:03d}"
events.append(SaleEvent(
event_type="SALE", external_event_id=f"{order_id}-S", external_order_id=order_id,
external_line_id="1", order_date=d, payment_date=d, event_date=d, amount=amount,
product_name=name, quantity=qty, discount_amount=discount, order_status="결제완료",
raw={"sample": True},
))
roll = rng.random()
if roll < 0.05: # 전체 취소(당일~2일 뒤)
cd = min(end, d + timedelta(days=rng.randint(0, 2)))
events.append(SaleEvent(
event_type="CANCEL", external_event_id=f"{order_id}-C", external_order_id=order_id,
external_line_id="1", order_date=d, payment_date=d, event_date=cd, amount=-amount,
product_name=name, quantity=-qty, order_status="취소완료", raw={"sample": True},
))
elif roll < 0.08 and qty > 1: # 부분 반품(1개, 3~7일 뒤)
rd = min(end, d + timedelta(days=rng.randint(3, 7)))
events.append(SaleEvent(
event_type="RETURN", external_event_id=f"{order_id}-R", external_order_id=order_id,
external_line_id="1", order_date=d, payment_date=d, event_date=rd, amount=-price,
product_name=name, quantity=-1, order_status="반품완료", raw={"sample": True},
))
d += timedelta(days=1)
return events
+27
View File
@@ -0,0 +1,27 @@
"""네이버 스마트스토어 — 네이버 커머스API.
인증: 애플리케이션 ID + 시크릿으로 전자서명(bcrypt) → OAuth2 client_credentials 토큰.
토큰은 발급받아 암호화 저장하고 만료 시 재발급한다(다음 단계에서 구현).
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class NaverAdapter(MarketplaceAdapter):
code = "naver"
name = "네이버 스마트스토어"
auth_type = "oauth"
docs_url = "https://apicenter.commerce.naver.com/"
note = "커머스API센터에서 발급한 애플리케이션 ID/시크릿을 입력합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("client_id", "애플리케이션 ID(Client ID)"),
CredentialField("client_secret", "애플리케이션 시크릿(Client Secret)", secret=True),
CredentialField("account_id", "판매자 ID", required=False,
help="판매자 계정 지정이 필요한 경우에만 입력"),
CredentialField("access_token", "Access Token", secret=True, required=False, internal=True),
CredentialField("access_token_expires_at", "Access Token 만료", required=False, internal=True),
]
@@ -0,0 +1,22 @@
"""오늘의집 — 파트너(판매자) API.
인증 방식·필드는 연동 단계에서 오늘의집 파트너 API 문서로 확정한다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class OhouseAdapter(MarketplaceAdapter):
code = "ohouse"
name = "오늘의집"
auth_type = "api_key"
note = "입력 항목은 연동 단계에서 오늘의집 파트너 API 문서로 확정합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("seller_id", "판매자 ID"),
CredentialField("api_key", "API Key", secret=True),
CredentialField("api_secret", "API Secret", secret=True, required=False),
]
@@ -0,0 +1,41 @@
"""쇼핑몰 어댑터 목록 — 새 쇼핑몰은 여기 한 줄 + 어댑터 파일 하나.
DB(perf_marketplaces)에 행이 없으면 설정 화면에서 쓸 수 없으므로, 새 쇼핑몰을
추가할 때는 scripts/sql 의 seed(INSERT … ON CONFLICT DO NOTHING)에도 한 줄 넣는다.
"""
from __future__ import annotations
from .base import MarketplaceAdapter
from .cafe24 import Cafe24Adapter
from .coupang import CoupangAdapter
from .elevenst import ElevenstAdapter
from .gmarket import GmarketAdapter
from .gsshop import GsshopAdapter
from .kakao import KakaoAdapter
from .lotteon import LotteonAdapter
from .naver import NaverAdapter
from .ohouse import OhouseAdapter
from .toss import TossAdapter
_ADAPTERS: tuple[MarketplaceAdapter, ...] = (
Cafe24Adapter(),
NaverAdapter(),
CoupangAdapter(),
OhouseAdapter(),
GmarketAdapter(),
KakaoAdapter(),
GsshopAdapter(),
ElevenstAdapter(),
LotteonAdapter(),
TossAdapter(),
)
_BY_CODE = {a.code: a for a in _ADAPTERS}
def all_adapters() -> tuple[MarketplaceAdapter, ...]:
return _ADAPTERS
def get_adapter(code: str) -> MarketplaceAdapter | None:
return _BY_CODE.get(code)
+22
View File
@@ -0,0 +1,22 @@
"""토스쇼핑 — 판매자 API.
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class TossAdapter(MarketplaceAdapter):
code = "toss"
name = "토스쇼핑"
auth_type = "api_key"
note = "입력 항목은 연동 단계에서 토스쇼핑 판매자 API 문서로 확정합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("seller_id", "판매자 ID"),
CredentialField("api_key", "API Key", secret=True),
CredentialField("api_secret", "API Secret", secret=True, required=False),
]