@@ -4,8 +4,9 @@
supCd = 협력사코드
token = AES256( Sysdate( " yyyyMMddHHmmss " ) + 협력사코드 ) 예: " 20181017174913 " + " 1036018 "
AES256 암복호화 키는 partners.gsshop.com/api/apiMain 에 로그인하면 보인다.
암호화 모드(CBC/ECB, IV)는 문서에 없다 → 흔한 순서(CBC·IV=키 앞 16바이트 → ECB → CBC·IV=0)로 시도하고
통과한 방식 을 기억한다(TOKEN_MODES) . 출력은 base64.
암호화 모드(CBC/ECB, IV)와 키를 바이트로 쓰는 법은 문서에 없다 → 키 변형(글자 그대로 / 16진수 풀기 / 앞 32자,
key_variants) × 모드(CBC·IV=키 앞 16바이트 → ECB → CBC·IV=0) 순서로 시도하고 통과한 조합 을 기억한다. 출력은 base64.
(포털 " 운영 KEY " 는 16진수처럼 보이는 글자 — 32자면 글자 그대로 AES256, 64자면 16진수로 풀어 32바이트일 수 있다.)
token 이 틀리면 HTTP 200 + { " result " : " fail " , " message " : " 키 인증 중 오류… " , " code " : " 401 UNAUTHORIZED " }.
주소: 운영 https://withgs-api.gsshop.com (개발가이드의 예시 주소 atwithgs-api 는 테스트용 — 두 곳 모두 응답 확인).
@@ -45,12 +46,32 @@ TOKEN_MODES = ("cbc-keyiv", "ecb", "cbc-zeroiv")
MODE_LABEL = { " cbc-keyiv " : " AES/CBC(IV=키 앞 16바이트) " , " ecb " : " AES/ECB " , " cbc-zeroiv " : " AES/CBC(IV=0) " }
def make_token ( aes_key : str , sup_cd : str , now : datetime , mode : str ) - > str :
""" token = base64(AES(yyyyMMddHHmmss + 협력사코드)), PKCS7(=PKCS5) 패딩. """
KEY_LABEL = { " text " : " 키 글자 그대로 " , " hex " : " 키 16진수 풀기 " , " first32 " : " 키 앞 32자 " }
def key_variants ( aes_key : str ) - > list [ tuple [ str , bytes ] ] :
""" AES 키로 쓸 수 있는 바이트 후보(시도 순서). 하나도 없으면 길이 오류. """
raw = aes_key . strip ( ) . encode ( " utf-8 " )
out : list [ tuple [ str , bytes ] ] = [ ]
if len ( raw ) in ( 16 , 24 , 32 ) :
out . append ( ( " text " , raw ) )
txt = aes_key . strip ( )
if len ( txt ) in ( 32 , 48 , 64 ) and all ( c in " 0123456789abcdefABCDEF " for c in txt ) :
out . append ( ( " hex " , bytes . fromhex ( txt ) ) )
if len ( raw ) > 32 :
out . append ( ( " first32 " , raw [ : 32 ] ) )
if not out :
raise AuthFailed ( f " AES 키 길이가 올바르지 않습니다( { len ( raw ) } 자). 제휴 API 메인 화면의 운영 KEY 를 "
" [복사] 버튼으로 복사해 그대로 붙여 넣으세요. " )
return out
def make_token ( aes_key : str | bytes , sup_cd : str , now : datetime , mode : str ) - > str :
""" token = base64(AES(yyyyMMddHHmmss + 협력사코드)), PKCS7(=PKCS5) 패딩. aes_key 가 글자면 그대로 바이트로. """
from cryptography . hazmat . primitives import padding # 지연 import
from cryptography . hazmat . primitives . ciphers import Cipher , algorithms , modes
key = aes_key . encode ( " utf-8 " )
key = aes_key if isinstance ( aes_key , bytes ) else aes_key . encode ( " utf-8 " )
if len ( key ) not in ( 16 , 24 , 32 ) :
raise AuthFailed ( f " AES 키 길이가 올바르지 않습니다( { len ( key ) } 바이트 — 16·24·32 중 하나여야 함). "
" 제휴 API 메인 화면의 키를 그대로 붙여 넣으세요. " )
@@ -82,18 +103,18 @@ class GsshopAdapter(MarketplaceAdapter):
name = " GS샵 "
auth_type = " api_key "
docs_url = " https://partners.gsshop.com/api/apiDevGuide "
note = ( " GS SHOP 협력사 포털(partners.gsshop.com) → 제휴 API 메인 화면에 로그인하면 보이는 협력사코드와 "
" AES256 암복호화 키를 입력합 니다." )
note = ( " GS SHOP 협력사 포털(partners.gsshop.com) → 제휴 API 메인 화면의 협력사코드와 "
" 운영 KEY(오른쪽 [복사] 버튼)를 입력합니다. 개발 KEY 가 아니라 운영 KEY 입 니다." )
def __init__ ( self ) - > None :
self . _mode : dict [ str , str ] = { } # 협력사코드 → 통과한 암호화 모드
self . _mode : dict [ str , tuple [ str , str ] ] = { } # 협력사코드 → 통과한 (키 변형, 암호화 모드)
def credential_fields ( self ) - > list [ CredentialField ] :
# 키 이름(vendor_code·api_key)은 처음 만든 입력칸 그대로 — 이미 저장한 값을 다시 넣지 않아도 되게.
return [
CredentialField ( " vendor_code " , " 협력사코드(supCd) " , help = " 예: 1036018 " ) ,
CredentialField ( " api_key " , " AES256 암복호화 키 " , secret = True ,
help = " 제휴 API 메인 화면(로그인 후)에 표시되는 키 " ) ,
CredentialField ( " api_key " , " 운영 KEY( AES256 암복호화 키) " , secret = True ,
help = " 제휴 API 메인 화면의 운영 KEY — [복사] 버튼으로 복사해 붙여 넣기 " ) ,
]
# ── 호출 ──────────────────────────────────────────────
@@ -104,13 +125,14 @@ class GsshopAdapter(MarketplaceAdapter):
raise NotConfigured ( " 협력사코드와 AES256 키를 입력하세요. " )
return sup , key
def _call ( self , ctx : AdapterContext , path : str , params : dict [ str , Any ] , mode : str ) - > dict [ str , Any ] :
def _call ( self , ctx : AdapterContext , path : str , params : dict [ str , Any ] , how : tuple [ str , str ] ) - > dict [ str , Any ] :
import httpx # 지연 import
from app . timezone import now_kst # noqa: WPS433
sup , key = self . _creds ( ctx )
headers = { " supCd " : sup , " token " : make_token ( key , sup , now_kst ( ) , mode ) , " Accept " : " application/json " }
key_bytes = dict ( key_variants ( key ) ) [ how [ 0 ] ]
headers = { " supCd " : sup , " token " : make_token ( key_bytes , sup , now_kst ( ) , how [ 1 ] ) , " Accept " : " application/json " }
try :
res = httpx . get ( f " { HOST } { path } " , params = { " supCode " : sup , * * params } , headers = headers , timeout = ctx . timeout_sec )
except httpx . HTTPError as exc :
@@ -130,22 +152,23 @@ class GsshopAdapter(MarketplaceAdapter):
return body
def _get ( self , ctx : AdapterContext , path : str , params : dict [ str , Any ] ) - > dict [ str , Any ] :
""" 토큰 암호화 모드를 모르면 순서대로 시도 — 통과한 모드를 기억한다. """
sup , _ = self . _creds ( ctx )
""" 토큰 만드는 법(키 변형 × 암호화 모드)을 모르면 순서대로 시도 — 통과한 조합을 기억한다. """
sup , key = self . _creds ( ctx )
known = self . _mode . get ( sup )
if known :
return self . _call ( ctx , path , params , known )
tries = [ ( v , m ) for v , _ in key_variants ( key ) for m in TOKEN_MODES ]
last : AuthFailed | None = None
for mode in TOKEN_MODES :
for how in tries :
try :
body = self . _call ( ctx , path , params , mode )
body = self . _call ( ctx , path , params , how )
except AuthFailed as exc :
last = exc
continue
self . _mode [ sup ] = mode
self . _mode [ sup ] = how
return body
raise AuthFailed ( f " { last . message if last else ' GS샵 인증 실패 ' } — 암호화 방식 { len ( TOKEN_MODES ) } 가지 모두 거부. "
" 협력사코드·AES256 키 가 맞는지, 서버 시각이 정확한지 확인하세요. " )
raise AuthFailed ( f " { last . message if last else ' GS샵 인증 실패 ' } — 토큰 만드는 방식 { len ( tries ) } 가지 모두 거부. "
" 협력사코드·운영 KEY 가 맞는지, 서버 시각이 정확한지 확인하세요. " )
def _pages ( self , ctx : AdapterContext , path : str , lo : date , hi : date ) - > list [ dict [ str , Any ] ] :
""" [lo, hi] 를 10일씩 나눠 쪽을 넘겨 모두 받는다. """
@@ -174,7 +197,11 @@ class GsshopAdapter(MarketplaceAdapter):
body = self . _get ( ctx , DAILY_SALES_PATH , { " stdDate " : day . strftime ( " % Y % m %d " ) , " pageIdx " : 1 , " rowsPerPage " : 10 } )
total = body . get ( " totalCount " )
return ( f " GS샵 연결 정상(매출 내역 조회 확인, 어제 매출 { total if total is not None else len ( _rows ( body ) ) } 건, "
f " 토큰 { MODE_LABEL . get ( self . _mode . get ( sup , ' ' ) , ' ' ) } ). " )
f " 토큰 { self . _how_label ( sup ) } ). " )
def _how_label ( self , sup : str ) - > str :
v , m = self . _mode . get ( sup , ( " " , " " ) )
return f " { MODE_LABEL . get ( m , m ) } , { KEY_LABEL . get ( v , v ) } "
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
def reconcile ( self , ctx : AdapterContext , day : date , to : date | None = None ) - > dict [ str , Any ] :