diff --git a/app/modules/performance/adapters/elevenst.py b/app/modules/performance/adapters/elevenst.py index 2eb8b3b..f1eea47 100644 --- a/app/modules/performance/adapters/elevenst.py +++ b/app/modules/performance/adapters/elevenst.py @@ -1,11 +1,54 @@ """11번가 — 11번가 셀러 오픈API. -인증: 셀러오피스에서 발급한 Open API Key 를 요청 헤더(openapikey)에 넣는다. +인증: 셀러오피스(openapi.11st.co.kr → 서비스등록·확인)에서 발급한 Open API Key 를 요청 헤더 `openapikey` 에 넣는다. +셀러 API 는 등록한 IP 에서만 호출된다("Seller API 정보 수정"에서 서버 IP 등록, 셀링툴(사방넷 등)과 함께 쓸 수 있음). +(공식 이용방법 openapi.11st.co.kr → OpenApiOperationGuide SERVICE_METHOD, 2026-09-30 확인) + +연결 테스트는 결제완료(발주확인할) 주문 목록을 오늘 하루로 조회한다 — GET /rest/ordservices/complete/{시작}/{끝} +(yyyyMMddHHmm). 엔드포인트 상세 문서는 로그인 뒤에만 보여 널리 쓰이는 경로를 쓰고, 실제 호출 결과로 확인한다. +응답은 XML. 매출 수집(fetch_orders)은 맞출 셀러오피스 화면을 정한 뒤 구현한다. """ from __future__ import annotations -from .base import CredentialField, MarketplaceAdapter +import re +import xml.etree.ElementTree as ET +from typing import Any + +from .base import AdapterContext, ApiError, AuthFailed, CredentialField, MarketplaceAdapter + +HOST = "https://api.11st.co.kr" + + +def _xml_text(content: bytes) -> str: + """11번가 XML 은 euc-kr 선언이 많다 — 파이썬 XML 파서가 다바이트 인코딩 선언을 못 읽어 직접 풀고 선언을 뗀다.""" + head = content[:200].decode("ascii", "ignore") + m = re.search(r"encoding=[\"']([\w-]+)", head) + enc = (m.group(1) if m else "utf-8").lower() + try: + text = content.decode("cp949" if enc in ("euc-kr", "euckr", "ks_c_5601-1987") else enc) + except (LookupError, UnicodeDecodeError): + text = content.decode("utf-8", "replace") + return re.sub(r"^\s*<\?xml[^>]*\?>", "", text) + + +def xml_result(content: bytes) -> tuple[str, str, int]: + """(결과코드, 결과문구, 주문 수). 네임스페이스와 무관하게 태그 끝 이름으로 찾는다.""" + try: + root = ET.fromstring(_xml_text(content)) + except ET.ParseError: + return "", "", 0 + code = text = "" + orders = 0 + for el in root.iter(): + tag = el.tag.rsplit("}", 1)[-1].lower() + if tag in ("result_code", "resultcode") and not code: + code = (el.text or "").strip() + elif tag in ("result_text", "resulttext", "result_message", "message") and not text: + text = (el.text or "").strip() + elif tag == "order": + orders += 1 + return code, text, orders class ElevenstAdapter(MarketplaceAdapter): @@ -13,9 +56,38 @@ class ElevenstAdapter(MarketplaceAdapter): name = "11번가" auth_type = "api_key" docs_url = "https://openapi.11st.co.kr/" - note = "11번가 셀러오피스 → 오픈API 에서 발급한 키를 입력합니다." + note = ("11번가 셀러오피스 → 오픈API 에서 발급한 키를 입력합니다. 셀러 API 는 등록한 IP 에서만 호출되므로 " + "'Seller API 정보 수정 → IP 직접 입력'에 이 서버의 외부 IP 를 넣어야 합니다.") def credential_fields(self) -> list[CredentialField]: return [ CredentialField("api_key", "Open API Key", secret=True), ] + + def _get(self, ctx: AdapterContext, path: str) -> bytes: + import httpx # 지연 import + + headers = {"openapikey": ctx.credentials.get("api_key").strip(), "Accept": "application/xml"} + try: + res = httpx.get(f"{HOST}{path}", headers=headers, timeout=ctx.timeout_sec) + except httpx.HTTPError as exc: + raise ApiError(f"11번가 API 연결 실패: {type(exc).__name__} — 등록한 IP 가 이 서버 IP 인지 확인하세요.") from None + code, text, _ = xml_result(res.content) + detail = text or res.text[:200].strip() + if res.status_code in (401, 403): + raise AuthFailed(f"11번가 인증 거부({res.status_code}): {detail}. 키와 등록 IP(이 서버 외부 IP)를 확인하세요.") + if res.status_code >= 400: + raise ApiError(f"11번가 API 오류({res.status_code}): {detail}") + if code and code not in ("0", "200", "00"): + raise ApiError(f"11번가 API 오류(코드 {code}): {detail}") + return res.content + + def test_connection(self, ctx: AdapterContext) -> str: + from app.timezone import today_kst # noqa: WPS433 + + self.authenticate(ctx) + d = today_kst().strftime("%Y%m%d") + body = self._get(ctx, f"/rest/ordservices/complete/{d}0000/{d}2359") + _, _, orders = xml_result(body) + return (f"11번가 연결 정상(주문 조회 권한 확인, 오늘 결제완료 {orders}건). " + "매출 수집은 다음 단계에서 구현됩니다.") diff --git a/app/modules/performance/tests/test_performance.py b/app/modules/performance/tests/test_performance.py index fce4c7c..ec5ce5b 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -13,6 +13,7 @@ from decimal import Decimal from app.modules.performance import calc from app.modules.performance.adapters import mock from app.modules.performance.adapters.base import ( + ApiError, AuthFailed, CredentialField, MarketplaceAdapter, @@ -387,7 +388,12 @@ def test_not_implemented_and_mock(): creds.save(next(a for a in all_adapters() if a.code == "elevenst"), {"api_key": "k-123456"}) r = svc.sync_marketplace("elevenst", date(2026, 9, 29), date(2026, 9, 29)) assert r["status"] == "not_implemented" and "k-123456" not in r["message"] - t = svc.test_connection("elevenst", values={"api_key": "typed-only"}) + import httpx + orig_get, httpx.get = httpx.get, (lambda url, headers=None, timeout=None: httpx.Response(200, content=b"")) + try: + t = svc.test_connection("elevenst", values={"api_key": "typed-only"}) + finally: + httpx.get = orig_get assert t["unsaved"] and "test" not in st.status.get("elevenst", {}) # 저장 안 한 값 시험은 상태 기록 안 함 a = mock.generate("naver", date(2026, 9, 1), date(2026, 9, 30)) b = mock.generate("naver", date(2026, 9, 1), date(2026, 9, 30)) @@ -803,6 +809,52 @@ def test_coupang_hmac_and_connection_errors(): httpx.get = orig +def test_elevenst_connection(): + """11번가: openapikey 헤더 + 결제완료 주문 조회(XML). 오류 코드·403 구분, 키는 메시지에 없음.""" + import httpx + + from app.modules.performance.adapters import elevenst as ev + from app.modules.performance.adapters.base import AdapterContext + + class Creds(dict): + def get(self, k, default=""): + return dict.get(self, k, default) + + def has(self, k): + return bool(dict.get(self, k)) + + ctx = AdapterContext(code="elevenst", credentials=Creds(api_key="KEY-11ST-SECRET")) + seen = {} + ok_xml = ('12' + '').encode("euc-kr") + + def fake(status, content): + def get(url, headers=None, timeout=None): + seen["url"], seen["key"] = url, headers["openapikey"] + return httpx.Response(status, content=content) + return get + + orig = httpx.get + try: + httpx.get = fake(200, ok_xml) + msg = ev.ElevenstAdapter().test_connection(ctx) + assert "연결 정상" in msg and "2건" in msg and seen["key"] == "KEY-11ST-SECRET" + assert "/rest/ordservices/complete/" in seen["url"] + err = '-1허용되지 않은 IP' + for status, body, kind in ((200, err.encode(), ApiError), (403, b"Forbidden", AuthFailed)): + httpx.get = fake(status, body) + try: + ev.ElevenstAdapter().test_connection(ctx) + except kind as exc: + assert "KEY-11ST-SECRET" not in exc.message + assert status == 403 or "허용되지 않은 IP" in exc.message + else: + raise AssertionError("오류여야 합니다") + finally: + httpx.get = orig + + def test_registry_and_event_validation(): codes = [a.code for a in all_adapters()] assert len(codes) == len(set(codes)) == 10