{"openapi":"3.1.0","info":{"title":"Rimbol Agent Commerce API","version":"2026-04-17","description":"AI 에이전트용 쇼핑 API. 조회는 인증 없이 가능. 금액은 KRW 정수. 이 플랫폼은 통신판매중개자이며 거래 당사자가 아닙니다. 상품·배송·교환·환불 책임은 판매자에게 있고, 결제대금은 판매자의 PG로 직접 지급됩니다. 안내서: https://rimbol.shop/llms.txt"},"servers":[{"url":"https://rimbol.shop/api/v1"}],"paths":{"/products":{"get":{"operationId":"searchProducts","summary":"상품 검색 (가격·배송·재고·판매자 정보 포함)","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"공백 구분 한국어 키워드"},{"name":"ids","in":"query","schema":{"type":"string"},"description":"쉼표 구분 상품 ID 일괄 조회 (최대 20, 다른 필터 무시)"},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"min_price","in":"query","schema":{"type":"integer"}},{"name":"max_price","in":"query","schema":{"type":"integer"}},{"name":"in_stock","in":"query","schema":{"type":"boolean"}},{"name":"sort","in":"query","schema":{"enum":["relevance","price_asc","price_desc","newest"]}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string"},"markdown_url":{"type":"string"},"name":{"type":"string"},"brand":{"type":["string","null"]},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"attributes":{"type":"object","additionalProperties":{"type":"string"}},"gtin":{"type":["string","null"]},"images":{"type":"array","items":{"type":"string"}},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"원(KRW)"},"currency":{"const":"KRW"},"display":{"type":"string"}},"description":"옵션 최저가 (max_amount 는 최고가)"},"purchase":{"type":"object","properties":{"variant_required":{"type":"boolean"},"default_variant_id":{"type":["string","null"]}}},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"variants":{"type":"array","description":"주문 단위. line_items[].id 에 variants[].id 사용","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"options":{"type":"object","additionalProperties":{"type":"string"}},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"원(KRW)"},"currency":{"const":"KRW"},"display":{"type":"string"}}},"availability":{"type":"object"}}}},"availability":{"type":"object","properties":{"status":{"enum":["in_stock","low_stock","out_of_stock"]},"quantity":{"type":"integer"}}},"shipping":{"type":"object","properties":{"fee":{"type":"object","properties":{"amount":{"type":"integer","description":"원(KRW)"},"currency":{"const":"KRW"},"display":{"type":"string"}}},"dispatch_business_days":{"type":"integer"},"ships_to":{"type":"array","items":{"type":"string"}},"policy":{"type":["string","null"]}}},"return_policy":{"type":["string","null"]},"seller":{"type":"object","description":"전자상거래법상 판매자 신원정보"}}}},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}}},"/products/{id}":{"get":{"operationId":"getProduct","summary":"상품 상세","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string"},"markdown_url":{"type":"string"},"name":{"type":"string"},"brand":{"type":["string","null"]},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"attributes":{"type":"object","additionalProperties":{"type":"string"}},"gtin":{"type":["string","null"]},"images":{"type":"array","items":{"type":"string"}},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"원(KRW)"},"currency":{"const":"KRW"},"display":{"type":"string"}},"description":"옵션 최저가 (max_amount 는 최고가)"},"purchase":{"type":"object","properties":{"variant_required":{"type":"boolean"},"default_variant_id":{"type":["string","null"]}}},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"variants":{"type":"array","description":"주문 단위. line_items[].id 에 variants[].id 사용","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"options":{"type":"object","additionalProperties":{"type":"string"}},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"원(KRW)"},"currency":{"const":"KRW"},"display":{"type":"string"}}},"availability":{"type":"object"}}}},"availability":{"type":"object","properties":{"status":{"enum":["in_stock","low_stock","out_of_stock"]},"quantity":{"type":"integer"}}},"shipping":{"type":"object","properties":{"fee":{"type":"object","properties":{"amount":{"type":"integer","description":"원(KRW)"},"currency":{"const":"KRW"},"display":{"type":"string"}}},"dispatch_business_days":{"type":"integer"},"ships_to":{"type":"array","items":{"type":"string"}},"policy":{"type":["string","null"]}}},"return_policy":{"type":["string","null"]},"seller":{"type":"object","description":"전자상거래법상 판매자 신원정보"}}}}}},"404":{"description":"오류 (message 에 고치는 방법 포함)","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":"string"}}}}}}}}},"/categories":{"get":{"operationId":"listCategories","summary":"카테고리 목록","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}}}}}}}}}},"/checkout_sessions":{"post":{"operationId":"createCheckoutSession","summary":"주문 준비 – continue_url 반환 (결제는 사용자가 직접)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"line_items":{"type":"array","maxItems":20,"items":{"type":"object","required":["id"],"properties":{"id":{"type":"string","format":"uuid","description":"옵션 ID (옵션이 1개뿐인 상품은 상품 ID 도 가능, 여러 개면 400 variant_required)"},"quantity":{"type":"integer","minimum":1,"maximum":99,"default":1}}}},"buyer":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"phone_number":{"type":"string"}}},"fulfillment_details":{"type":"object","properties":{"address":{"type":"object","properties":{"name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"state":{"type":"string","description":"시/도"},"city":{"type":"string","description":"시/군/구"},"line_one":{"type":"string"},"line_two":{"type":"string"},"country":{"const":"KR"}}}}}}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","description":"ACP checkout session 형태. 결제는 continue_url 에서 사용자가 직접.","properties":{"id":{"type":"string"},"status":{"enum":["requires_escalation","not_ready_for_payment","in_progress","completed","expired","canceled"]},"currency":{"const":"krw"},"line_items":{"type":"array","items":{"type":"object"}},"totals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"display_text":{"type":"string"},"amount":{"type":"integer"}}}},"fulfillment_options":{"type":"array","items":{"type":"object"}},"continue_url":{"type":["string","null"],"description":"사용자에게 전달할 결제 링크"},"orders":{"type":"array","items":{"type":"object"}},"messages":{"type":"array","items":{"type":"object"}},"expires_at":{"type":"string","format":"date-time"}}}}}},"400":{"description":"오류 (message 에 고치는 방법 포함)","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":"string"}}}}}}}}},"/checkout_sessions/{id}":{"get":{"operationId":"getCheckoutSession","summary":"주문 상태","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"ACP checkout session 형태. 결제는 continue_url 에서 사용자가 직접.","properties":{"id":{"type":"string"},"status":{"enum":["requires_escalation","not_ready_for_payment","in_progress","completed","expired","canceled"]},"currency":{"const":"krw"},"line_items":{"type":"array","items":{"type":"object"}},"totals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"display_text":{"type":"string"},"amount":{"type":"integer"}}}},"fulfillment_options":{"type":"array","items":{"type":"object"}},"continue_url":{"type":["string","null"],"description":"사용자에게 전달할 결제 링크"},"orders":{"type":"array","items":{"type":"object"}},"messages":{"type":"array","items":{"type":"object"}},"expires_at":{"type":"string","format":"date-time"}}}}}},"404":{"description":"오류 (message 에 고치는 방법 포함)","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":"string"}}}}}}}},"post":{"operationId":"updateCheckoutSession","summary":"장바구니·배송지 수정 (결제 시작 전까지)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"line_items":{"type":"array","maxItems":20,"items":{"type":"object","required":["id"],"properties":{"id":{"type":"string","format":"uuid","description":"옵션 ID (옵션이 1개뿐인 상품은 상품 ID 도 가능, 여러 개면 400 variant_required)"},"quantity":{"type":"integer","minimum":1,"maximum":99,"default":1}}}},"buyer":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"phone_number":{"type":"string"}}},"fulfillment_details":{"type":"object","properties":{"address":{"type":"object","properties":{"name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"state":{"type":"string","description":"시/도"},"city":{"type":"string","description":"시/군/구"},"line_one":{"type":"string"},"line_two":{"type":"string"},"country":{"const":"KR"}}}}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"ACP checkout session 형태. 결제는 continue_url 에서 사용자가 직접.","properties":{"id":{"type":"string"},"status":{"enum":["requires_escalation","not_ready_for_payment","in_progress","completed","expired","canceled"]},"currency":{"const":"krw"},"line_items":{"type":"array","items":{"type":"object"}},"totals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"display_text":{"type":"string"},"amount":{"type":"integer"}}}},"fulfillment_options":{"type":"array","items":{"type":"object"}},"continue_url":{"type":["string","null"],"description":"사용자에게 전달할 결제 링크"},"orders":{"type":"array","items":{"type":"object"}},"messages":{"type":"array","items":{"type":"object"}},"expires_at":{"type":"string","format":"date-time"}}}}}},"409":{"description":"오류 (message 에 고치는 방법 포함)","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":"string"}}}}}}}}},"/checkout_sessions/{id}/cancel":{"post":{"operationId":"cancelCheckoutSession","summary":"취소 (결제 전까지)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"ACP checkout session 형태. 결제는 continue_url 에서 사용자가 직접.","properties":{"id":{"type":"string"},"status":{"enum":["requires_escalation","not_ready_for_payment","in_progress","completed","expired","canceled"]},"currency":{"const":"krw"},"line_items":{"type":"array","items":{"type":"object"}},"totals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"display_text":{"type":"string"},"amount":{"type":"integer"}}}},"fulfillment_options":{"type":"array","items":{"type":"object"}},"continue_url":{"type":["string","null"],"description":"사용자에게 전달할 결제 링크"},"orders":{"type":"array","items":{"type":"object"}},"messages":{"type":"array","items":{"type":"object"}},"expires_at":{"type":"string","format":"date-time"}}}}}},"409":{"description":"오류 (message 에 고치는 방법 포함)","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":"string"}}}}}}}}},"/checkout_sessions/{id}/complete":{"post":{"operationId":"completeCheckoutSession","summary":"에이전트 대리결제 미지원 – 항상 continue_url 안내 (409)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"이미 완료됨","content":{"application/json":{"schema":{"type":"object","description":"ACP checkout session 형태. 결제는 continue_url 에서 사용자가 직접.","properties":{"id":{"type":"string"},"status":{"enum":["requires_escalation","not_ready_for_payment","in_progress","completed","expired","canceled"]},"currency":{"const":"krw"},"line_items":{"type":"array","items":{"type":"object"}},"totals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"display_text":{"type":"string"},"amount":{"type":"integer"}}}},"fulfillment_options":{"type":"array","items":{"type":"object"}},"continue_url":{"type":["string","null"],"description":"사용자에게 전달할 결제 링크"},"orders":{"type":"array","items":{"type":"object"}},"messages":{"type":"array","items":{"type":"object"}},"expires_at":{"type":"string","format":"date-time"}}}}}},"409":{"description":"사용자 결제 필요","content":{"application/json":{"schema":{"type":"object","description":"ACP checkout session 형태. 결제는 continue_url 에서 사용자가 직접.","properties":{"id":{"type":"string"},"status":{"enum":["requires_escalation","not_ready_for_payment","in_progress","completed","expired","canceled"]},"currency":{"const":"krw"},"line_items":{"type":"array","items":{"type":"object"}},"totals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"display_text":{"type":"string"},"amount":{"type":"integer"}}}},"fulfillment_options":{"type":"array","items":{"type":"object"}},"continue_url":{"type":["string","null"],"description":"사용자에게 전달할 결제 링크"},"orders":{"type":"array","items":{"type":"object"}},"messages":{"type":"array","items":{"type":"object"}},"expires_at":{"type":"string","format":"date-time"}}}}}}}}}}}