king
87fca22ea0
상단 공통 홍보를 스킨 쪽에서 처리할 수 있는지 실물로 확인하려면 토큰에 디자인 권한이 있어야 한다. 개발자센터 앱에는 이미 추가됐고, 우리가 요청하는 scope 에도 넣는다. 재인증을 해야 실제 토큰에 반영된다. 확인해 둔 사실을 config.py 주석으로 남겼다. 카페24 Admin API 에는 스킨 HTML 파일(detail.html)을 직접 읽거나 쓰는 엔드포인트가 없다. 조회 가능한 것은 테마 목록과 테마 페이지뿐이며, 스크립트 태그 주입은 디자인이 아니라 mall.write_store 권한이고 인라인 코드가 아닌 외부 HTTPS URL 만 받는다. 요청 scope 를 DEFAULT_SCOPES 한 곳으로 모아, 앞으로 늘어날 때 authorize 와 클라이언트가 어긋나지 않게 했다. 검증: 유닛테스트 49개 통과. scope_param 출력 확인. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
96 lines
2.6 KiB
Python
96 lines
2.6 KiB
Python
"""카페24 연동 공통 계층 (상품관리 + 향후 주문관리 공유).
|
|
|
|
구성
|
|
config.py 환경변수 → Cafe24Config (하드코딩 금지)
|
|
crypto.py 토큰 Fernet 암복호화
|
|
oauth.py 인증 URL / code→token / refresh
|
|
tokens.py TokenService — 저장·만료판정·자동갱신(행 잠금)
|
|
client.py Cafe24Client — 전송·재시도·429/5xx·API 로그
|
|
products.py 상품 엔드포인트 래퍼
|
|
errors.py 공통 예외
|
|
|
|
사용 예 (모듈 라우터에서):
|
|
|
|
from app.integrations.cafe24 import build_cafe24_api
|
|
|
|
api = build_cafe24_api(store) # store = Cafe24Store
|
|
html = products.get_description(api.client, 123)
|
|
|
|
CAFE24_* 환경변수가 없어도 import 는 성공한다. 실제 호출 시점에
|
|
Cafe24ConfigError 가 나며, 라우터가 "설정 필요" 안내를 보여준다.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from typing import Any
|
|
|
|
from . import products
|
|
from .client import Cafe24Client
|
|
from .config import (
|
|
DEFAULT_SCOPES,
|
|
DESIGN_SCOPES,
|
|
ORDER_SCOPES,
|
|
PRODUCT_SCOPES,
|
|
Cafe24Config,
|
|
load_config,
|
|
)
|
|
from .errors import (
|
|
Cafe24ApiError,
|
|
Cafe24AuthError,
|
|
Cafe24ConfigError,
|
|
Cafe24Error,
|
|
Cafe24RateLimitError,
|
|
)
|
|
from .oauth import TokenBundle, build_authorize_url, exchange_code, new_state, refresh_tokens
|
|
from .tokens import TokenService
|
|
|
|
__all__ = [
|
|
"Cafe24Api",
|
|
"build_cafe24_api",
|
|
"Cafe24Client",
|
|
"Cafe24Config",
|
|
"TokenService",
|
|
"TokenBundle",
|
|
"load_config",
|
|
"build_authorize_url",
|
|
"exchange_code",
|
|
"refresh_tokens",
|
|
"new_state",
|
|
"products",
|
|
"PRODUCT_SCOPES",
|
|
"ORDER_SCOPES",
|
|
"DESIGN_SCOPES",
|
|
"DEFAULT_SCOPES",
|
|
"Cafe24Error",
|
|
"Cafe24ConfigError",
|
|
"Cafe24AuthError",
|
|
"Cafe24RateLimitError",
|
|
"Cafe24ApiError",
|
|
]
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Cafe24Api:
|
|
"""설정 + 토큰서비스 + 클라이언트 묶음. 라우터/worker 가 이것만 들고 다닌다."""
|
|
|
|
config: Cafe24Config
|
|
tokens: TokenService
|
|
client: Cafe24Client
|
|
|
|
|
|
def build_cafe24_api(store: Any, *, scopes: tuple[str, ...] = DEFAULT_SCOPES) -> Cafe24Api:
|
|
"""Cafe24Store 를 저장소로 쓰는 API 묶음 생성.
|
|
|
|
store 는 토큰 3개 메서드(get_token_row/save_token_row/token_lock)와
|
|
API 로그 기록용 log_api_call 을 제공해야 한다.
|
|
"""
|
|
config = load_config(scopes=scopes)
|
|
token_service = TokenService(store, config)
|
|
client = Cafe24Client(
|
|
config,
|
|
token_service,
|
|
api_logger=getattr(store, "log_api_call", None),
|
|
)
|
|
return Cafe24Api(config=config, tokens=token_service, client=client)
|