{"openapi":"3.1.0","info":{"title":"AfterSwim Agent API","version":"2026-10-13","description":"애프터스윔(afterswim.kr) 회원이 연결한 AI 비서가 회원 대신 상품 견적·주문·배송 조회를 하는 API. 인증은 회원이 마이페이지 › AI 비서 연결에서 발급한 키(Bearer ask_live_…). 결제는 회원이 등록해 둔 카드로 결제창 없이 즉시 승인된다. 회원이 결제수단마다 정한 1회·월 한도를 넘는 주문은 거부되며, 키 1개당 하루 10건까지. 상품 목록은 공개 피드 https://afterswim.kr/feeds/acp.json."},"servers":[{"url":"https://afterswim.kr"}],"components":{"securitySchemes":{"agentToken":{"type":"http","scheme":"bearer","description":"ask_live_ 로 시작하는 비서 연결 키"}},"schemas":{"OrderSummary":{"type":"object","properties":{"id":{"type":"string"},"order_no":{"type":"string","nullable":true},"status":{"type":"string","enum":["pending","paid","partially_refunded","refunded","failed"]},"fulfillment_status":{"type":"string"},"amount":{"type":"integer"},"currency":{"type":"string","enum":["KRW"]},"items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","nullable":true},"name":{"type":"string"},"option":{"type":"string","nullable":true},"qty":{"type":"integer"},"unit_price":{"type":"integer"}}}},"created_at":{"type":"string"},"paid_at":{"type":"string","nullable":true},"shipped_at":{"type":"string","nullable":true},"delivered_at":{"type":"string","nullable":true},"carrier":{"type":"string","nullable":true},"tracking_no":{"type":"string","nullable":true},"lookup_url":{"type":"string"}}},"Error":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"code":{"type":"string"},"message":{"type":"string"}}}}},"security":[{"agentToken":[]}],"paths":{"/api/agent/me":{"get":{"operationId":"getMe","summary":"연결된 회원 요약 — 기본 배송지, 비서 주문이 허용된 결제수단과 한도","responses":{"200":{"description":"회원 요약"},"401":{"description":"키 없음/해지","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"/api/agent/quote":{"post":{"operationId":"quote","summary":"견적 — 가격·재고·배송비 확인(주문 아님)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["sku","qty"],"properties":{"sku":{"type":"string"},"qty":{"type":"integer","minimum":1,"maximum":99}}}}}}}}},"responses":{"200":{"description":"quote.ok=false 면 issues 를 고쳐야 주문 가능"}}}},"/api/agent/orders":{"get":{"operationId":"listOrders","summary":"최근 주문 10건(중복 주문 방지용)","responses":{"200":{"description":"orders[]"}}},"post":{"operationId":"createOrder","summary":"주문 + 등록 카드 즉시 결제. 회원 한도·허용을 서버가 강제한다","description":"address_id·payment_method_id 를 생략하면 기본 배송지·기본(비서 허용) 결제수단. idempotency_key 를 주면 같은 키의 재호출은 같은 주문을 돌려준다. 결제 직전에 회원 휴대폰으로 품목·금액·카드와 1탭 취소 링크가 문자로 발송된다(회원이 링크로 취소하면 출고 전 전액 승인취소). 403=회원 한도/허용 거부(code: agent_not_allowed | per_order_limit | monthly_limit | daily_cap), 409=재고·배송지·결제수단 문제, 402=카드 승인 실패.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["sku","qty"],"properties":{"sku":{"type":"string"},"qty":{"type":"integer"}}}},"address_id":{"type":"string"},"payment_method_id":{"type":"string"},"idempotency_key":{"type":"string","maxLength":80},"memo":{"type":"string","description":"배송 메모"}}}}}},"responses":{"201":{"description":"주문 생성·결제 완료","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"order":{"type":"object","properties":{"id":{"type":"string"},"order_no":{"type":"string","nullable":true},"status":{"type":"string","enum":["pending","paid","partially_refunded","refunded","failed"]},"fulfillment_status":{"type":"string"},"amount":{"type":"integer"},"currency":{"type":"string","enum":["KRW"]},"items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","nullable":true},"name":{"type":"string"},"option":{"type":"string","nullable":true},"qty":{"type":"integer"},"unit_price":{"type":"integer"}}}},"created_at":{"type":"string"},"paid_at":{"type":"string","nullable":true},"shipped_at":{"type":"string","nullable":true},"delivered_at":{"type":"string","nullable":true},"carrier":{"type":"string","nullable":true},"tracking_no":{"type":"string","nullable":true},"lookup_url":{"type":"string"}}}}}}}},"402":{"description":"카드 승인 실패","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"code":{"type":"string"},"message":{"type":"string"}}}}}},"403":{"description":"회원 한도/허용 거부","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"code":{"type":"string"},"message":{"type":"string"}}}}}},"409":{"description":"재고·배송지·결제수단 문제","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"/api/agent/orders/{id}":{"get":{"operationId":"getOrder","summary":"주문 상태·배송 추적","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"order","content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string"},"order_no":{"type":"string","nullable":true},"status":{"type":"string","enum":["pending","paid","partially_refunded","refunded","failed"]},"fulfillment_status":{"type":"string"},"amount":{"type":"integer"},"currency":{"type":"string","enum":["KRW"]},"items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","nullable":true},"name":{"type":"string"},"option":{"type":"string","nullable":true},"qty":{"type":"integer"},"unit_price":{"type":"integer"}}}},"created_at":{"type":"string"},"paid_at":{"type":"string","nullable":true},"shipped_at":{"type":"string","nullable":true},"delivered_at":{"type":"string","nullable":true},"carrier":{"type":"string","nullable":true},"tracking_no":{"type":"string","nullable":true},"lookup_url":{"type":"string"}}}}}}}},"404":{"description":"없음"}}}}}}