OPEN API

OPEN API
HOME>마이페이지>OPEN API

로그인 후 OPEN API 사용을 위한 인증키를 생성하세요.

카테고리 상품의 카테고리 조회

GET 카테고리 리스트

HOST

https://specialoffer.kr/api/categories

HEADERS

Authorization: Bearer {발급받은 api 인증키}

PARAMS

level: 조회할 카테고리 레벨(DEFAULT:1)
page: 페이지(DEFAULT:1)
per_page: 페이지당 아이템 갯수 (DEFAULT:15)
parent_code: 부모 카테고리 코드
name: 카테고리 이름(일치하는 카테고리만 반환)

GET 특정 카테고리 조회

상품 상품 조회 및 관리 상품API문서 다운로드

POST 상품등록 (공급사회원전용)

HOST

https://specialoffer.kr/api/seller/goods

HEADERS

Authorization: Bearer {발급받은 api 인증키}

PARAMS

category_code*: 대표 카테고리 코드
name*: 상품명
keywords: 검색키워드
brand_name: 브랜드
model_name: 모델명
origin*: 원산지
maker*: 제조사
order_end_at*: 발주마감시간
09:00~17:30 (30분 간격으로 등록가능)
tax_type*: 과세설정
0:면세, 1:관세
state*: 판매여부
1:진열, 2:품절, 3:단종, 4:중지(비노출)
option_titles: 상품주문옵션제목
option_values: 상품주문옵션
add_supply_values: 상품 추가 옵션
price_type*: 상품가격타입
1:소비자가준수, 2:소비자가자율
supply_price*: 공급가격
origin_price: 소비자가
stock_type*: 재고적용탸입
0:제한없음, 1:제한있음
stock_qty: 재고수량
stock_type=1로 설정된경우 등록되는 재고수량
sale_start_date: 판매기간(시작일)
sale_end_date: 판매기간(종료일)
shipping_fee_type: 배송비유형
1:무료배송, 3:유료배송, 4:수량X배송비
shipping_fee_payment: 배송비결제
shipping_fee: 기본배송비
0:선불,1:착불
shipping_etc: 배송추가설명
image_1*: 상품이미지
URL로 입력하세요.
image_2*: 상품이미지
image_3 ~ image_6: 상품이미지
contents: 상세셜명
seller_notice: 판매자 상품공지
cert_type*: 인증유형구분
0:인증대상아님, 1:인증대상, 2:상세페이지별도표기
cert_info: 인증정보
info_code*: 상품정보고시 분류코드
info_value1 ~ info_value20: 상품정보고시 항목1~20
is_medical*: 의료기기여부
N : 의료기기 아님, Y : 의료기기
is_healthfood*: 건강기능식품여부
N : 건강기능식품 아님, Y : 건강기능식품
is_refundable*: 반품가능여부
1 : 반품가능, 2 : 반품불가, 3 : 조건부반품불가
non_refundable_conditions: 조건부반품불가사유
is_overseas_shipping*: 해외직배송여부
N : 해외직배송상품 아님, Y : 해외직배송상품
seller_goods_code: 업체상품코드

Example Request

    curl --location --request POST 'http://specialoffer.kr/api/seller/goods'
        --header 'Authorization: Bearer {발급받은 api 인증키}'
        --data-raw '{
            "category_code": "517502020",
            "name": "페라어스 여성 골프 하이드 메쉬1",
            "keywords": "여성의류,골프의류,조끼,여성골프조끼,메쉬조끼,여름조끼",
            "brand_name": "페라어스",
            "model_name": "AVFU6001S0",
            "origin": "해외|아시아|중국",
            "maker": "페라어스",
            "order_end_at": "14:30",
            "tax_type": "1",
            "state": "1",
            "option_titles": ["사이즈"],
            "option_values": [{
                    "values": ["S"],
                    "supply_price": 0,
                    "stock_qty": 9999
            },{
                "values": [
                    "M"
                ],
                "supply_price": 1500,
                "stock_qty": 9999
            },{
                "values": [
                    "L"
                ],
                "supply_price": 2500,
                "stock_qty": 9999
            }],
        "add_supply_values": [{
            "values": [
                "포장박스추가구매",
                "포장박스(소)"
            ],
            "supply_price": 2500,
            "stock_qty": 9999
        },{
            "values": [
                "포장박스추가구매",
                "포장박스(대)"
            ],
            "supply_price": 2500,
            "stock_qty": 9999
        }],
        "price_type": "0",
        "supply_price": 30000,
        "origin_price": 45000,
        "stock_type": "0",
        "stock_qty": "0",
        "sale_start_date": "2021-08-10",
        "sale_end_date": "2021-12-31",
        "shipping_fee_type": 3,
        "shipping_fee_payment": 0,
        "shipping_fee": 2500,
        "shipping_etc": "제주도(배송비+2500)",
        "image_1": "https://specialoffer.kr/data/goods/44RPPPNzAdKgxFcWHJmBBLyLXPMQ9Y.png",
        "image_2": "https://specialoffer.kr/data/goods/JW2bABeB7KQTQ29CvtMa2VUE71Tzsp.png",
        "image_3": "https://specialoffer.kr/data/goods/sQ7VXWWB7cWrqyA8dbta3TXgPq6nQv.jpg",
        "image_4": "https://specialoffer.kr/data/goods/FTKJ8uQcKXaJEMDKMW8zdd3p9Up5DH.jpg",
        "image_5": "https://specialoffer.kr/data/goods/XSnNVLm1vlMSLpt9Bj8j3DLXT5AMPZ.jpg",
        "image_6": "https://specialoffer.kr/data/goods/XSnNVLm1vlMSLpt9Bj8j3DLXT5AMPZ.jpg",
        "contents": "상품상세정보 (html사용가능)",
        "seller_notice": "식품의 특성상 단순 변심으로 인한 환불은 불가합니다.",
        "cert_type": "1",
        "cert_info": [
            "완구=top_03=인증기관=CB512R963-1017=인증상호=2019-05-12",
            "완구=top_03=인증기관=CB253R9635-1018=인증상호=2019-05-12"
        ],
        "info_gubun": "01",
        "info_value1": "상품페이지참고",
        "info_value2": "상품페이지참고",
        "info_value3": "상품페이지참고",
        "info_value4": "상품페이지참고",
        "info_value5": "상품페이지참고",
        "info_value6": "상품페이지참고",
        "info_value7": "상품페이지참고",
        "info_value8": "상품페이지참고",
        "info_value10": "상품페이지참고",
        "info_value11": "상품페이지참고",
        "info_value12": "상품페이지참고",
        "info_value13": "상품페이지참고",
        "info_value14": "상품페이지참고",
        "info_value15": "상품페이지참고",
        "info_value16": "상품페이지참고",
        "info_value17": "상품페이지참고",
        "info_value18": "상품페이지참고",
        "info_value19": "상품페이지참고",
        "info_value20": "상품페이지참고",
        "is_medical": "N",
        "is_healthfood": "N",
        "is_refundable": "1",
        "non_refundable_conditions": "",
        "is_overseas_shipping": "N",
        "seller_goods_code": "asdf1234"
    }

POST 상품수정 (공급사회원전용)

GET 상품목록조회

GET 특정상품조회

HOST

https://specialoffer.kr/api/goods/{goodsNo}

HEADERS

Authorization: Bearer {발급받은 api 인증키}

PARAMS

goodsNo: 조회할 상품번호

Example Response

    {
      "data": {
        "no": 245942,
        "code": "TC00245942",
        "category_code": "556519040",
        "name": "알파벳 초콜릿 만들기세트 우리 농산물로 만든 초코펜",
        "keywords": "빼빼로,초콜렛,파티,선물세트,유아,케이크,만들기,쿠키,초콜릿,.알파벳",
        "brand_name": "메이드초콜릿(자체제작 상품)",
        "model_name": "초콜릿",
        "origin": "국내산",
        "maker": "영동초콜릿(엠케이크)",
        "order_end_at": "15:00",
        "is_taxation": 1,
        "option_titles": [
          ""
        ],
        "option_values": [],
        "add_supply_values": [
          {
            "values": [
              "몰드",
              "A-1.한글만들기 몰드"
            ],
            "option_price": 1000,
            "stock_quantity": 9999
          },
          {
            "values": [
              "몰드",
              "A-2.과일만들기 몰드"
            ],
            "option_price": 1000,
            "stock_quantity": 9999
          },
          {
            "values": [
              "몰드",
              "A-3.알파벳만들기 몰드"
            ],
            "option_price": 1000,
            "stock_quantity": 9999
          },
          {
            "values": [
              "몰드",
              "A-4.동물만들기 몰드"
            ],
            "option_price": 1000,
            "stock_quantity": 9999
          },
          {
            "values": [
              "몰드",
              "A-5.꽃만들기 몰드"
            ],
            "option_price": 1000,
            "stock_quantity": 9999
          }
        ],
        "origin_price": 11000,
        "price": 10890,
        "price_type": "fix",
        "seller_code": "SC00005701",
        "is_overseas_shipping": "N",
        "is_refundable": "1",
        "non_refundable_conditions": "",
        "shipping_fee_type": 3,
        "shipping_fee_payment": 0,
        "shipping_fee": 2500,
        "shipping_etc": "제주도(배송비+2500)",
        "is_bundled_shipping": "Y",
        "detail_url": "https://specialoffer.kr/shop/view.php?index_no=245942",
        "is_medical": "N",
        "is_healthfood": "N",
        "cert_flag": "N",
        "image_1": "https://specialoffer.kr/data/goods/44RPPPNzAdKgxFcWHJmBBLyLXPMQ9Y.png",
        "image_2": "https://specialoffer.kr/data/goods/JW2bABeB7KQTQ29CvtMa2VUE71Tzsp.png",
        "image_3": "https://specialoffer.kr/data/goods/sQ7VXWWB7cWrqyA8dbta3TXgPq6nQv.jpg",
        "image_4": "https://specialoffer.kr/data/goods/FTKJ8uQcKXaJEMDKMW8zdd3p9Up5DH.jpg",
        "image_5": "https://specialoffer.kr/data/goods/XSnNVLm1vlMSLpt9Bj8j3DLXT5AMPZ.jpg",
        "seller_notice": "식품의 특성상 단순 변심으로 인한 환불은 불가합니다.",
        "content": "상품상세정보",
         "smartstore_category_code":"50001337", //스마트스토어카테고리
        "created_at": "2020-11-09 17:43:37",
        "updated_at": "2020-12-29 10:16:26"

      }
    }

주문 주문 등록 및 조회

POST 주문등록

GET 주문목록조회

GET 특정주문조회

GET 특정주문번호조회

주문서의 주문자를 기준으로 조회하는 기능입니다

HOST

https://specialoffer.kr/api/v2/orders/order-no/{order_no}

HEADERS

Authorization: Bearer {발급받은 api 인증키}

PARAMS

order_no: 조회할 주문주문번호

Example Response (주문서에 하나의 주문이 있는 경우)

    {
          "data": [
                {
                    "order_id": "123456",
                    "order_no": "21072917112345",
                    "seller_code": "SC00005044",
                    "order_state": 2,
                    "goods_name": "까사니 쿨러백 20리터",
                    "delivery_company": "",
                    "delivery_no": "",
                    "delivery_date": null,
                    "shop_memo": "",
                    "sum_qty": 10,
                    "goods_price": 13500,
                    "shipping_fee": 3600,
                    "total_price": 138600,
                    "pay_method": "적립금",
                    "use_point": 152100,
                    "is_escrow": "N",
                    "receiver_name": "성춘향",
                    "receiver_telephone": "063-1234-1234",
                    "receiver_cellphone": "010-1234-8765",
                    "receiver_zip": "590-701",
                    "receiver_addr": "전북 남원시 도통동 남원시청",
                    "receiver_addr2": "4호",
                    "receiver_addr3": "",
                    "receiver_addr_jibeon": "",
                    "memo": "부재시 집 앞에 놔주세요.(주문번호 : 123456)",
                    "image": "192597001.jpg",
                    "order_date": "2021-07-29 17:11:31",
                    "updated_at": "2021-07-29 17:11:31"
              }
          ]
    }

Example Response (주문서에 여러 주문이 있는 경우)

    {
          "data": [
                {
                    "order_id": "123456",
                    "order_no": "21072917112345",
                    "seller_code": "SC00005044",
                    "order_state": 2,
                    "goods_name": "까사니 쿨러백 20리터",
                    "delivery_company": "",
                    "delivery_no": "",
                    "delivery_date": null,
                    "shop_memo": "",
                    "sum_qty": 10,
                    "goods_price": 13500,
                    "shipping_fee": 3600,
                    "total_price": 138600,
                    "pay_method": "적립금",
                    "use_point": 152100,
                    "is_escrow": "N",
                    "receiver_name": "성춘향",
                    "receiver_telephone": "063-1234-1234",
                    "receiver_cellphone": "010-1234-8765",
                    "receiver_zip": "590-701",
                    "receiver_addr": "전북 남원시 도통동 남원시청",
                    "receiver_addr2": "4호",
                    "receiver_addr3": "",
                    "receiver_addr_jibeon": "",
                    "memo": "부재시 집 앞에 놔주세요.(주문번호 : 123456)",
                    "image": "192597001.jpg",
                    "order_date": "2021-07-29 17:11:31",
                    "updated_at": "2021-07-29 17:11:31"
              },
              {
                  "order_id": "7890123",
                  "order_no": "21072917112345",
                  "seller_code": "SC00005044",
                  "order_state": 2,
                  "goods_name": "까사니 쿨러백 20리터",
                  "delivery_company": "",
                  "delivery_no": "",
                  "delivery_date": null,
                  "shop_memo": "",
                  "sum_qty": 10,
                  "goods_price": 13500,
                  "shipping_fee": 3600,
                  "total_price": 138600,
                  "pay_method": "적립금",
                  "use_point": 152100,
                  "is_escrow": "N",
                  "receiver_name": "성춘향",
                  "receiver_telephone": "063-1234-1234",
                  "receiver_cellphone": "010-1234-8765",
                  "receiver_zip": "590-701",
                  "receiver_addr": "전북 남원시 도통동 남원시청",
                  "receiver_addr2": "4호",
                  "receiver_addr3": "",
                  "receiver_addr_jibeon": "",
                  "memo": "부재시 집 앞에 놔주세요.(주문번호 : 123456)",
                  "image": "192597001.jpg",
                  "order_date": "2021-07-29 17:11:31",
                  "updated_at": "2021-07-29 17:11:31"
              }
          ]
    }

POST 특정주문취소

GET 공급사 주문목록조회 (공급사전용)

GET 공급사 특정주문조회 (공급사전용)

POST 특정주문취소 (공급사전용)

PATCH 배송정보업데이트 (공급사전용)

고객센터: 상담 : 평일 09:30 ~ 17:30 (토/일/공휴일 휴무); 점심 : 12:30 ~ 13:30

입금계좌안내 은행 및 예금주를 확인해주세요: 전용가상계좌발급; 은행명 : 국민은행 / 예금주 : (주)탑커머스; 입점신청 제휴문의

(주)탑커머스 대표자 : 나이엽 서울특별시 금천구 가산디지털2로 70 대륭테크노타운 19차 511호
사업자등록번호 : 113-86-63057 사업자정보확인 통신판매업신고 : 제2018-서울금천-0113호
고객센터 : 1:1상담문의 FAX : 02-3289-6860 Email : top@specialoffer.kr
개인정보보호책임자 : 관리팀장 (top@specialoffer.kr)
(주)탑커머스는 통신판매중개자로서 통신판매의 당사자가 아니며, 공급사가 등록한 상품정보 및 거래에 대해 (주)탑커머스 스페셜오퍼는 일체 책임을 지지 않습니다. (주)탑커머스 스페셜오퍼 사이트의 상품/판매자 거래 정보 및 콘텐츠/UI 등에 대한 무단 복제, 전송, 배포, 스크래핑 등의 행위는 저작권법, 콘텐츠 산업 진흥법 등에 의하여 엄격히 금지합니다.

Copyright ⓒ (주)탑커머스 All rights reserved.
에스크로 구매안전서비스
고객님은 안전거래를 위해 현금으로 결제시 구매자가 보호를 받을 수 있는 구매안전서비스(에스크로)를 이용하실 수 있습니다.
서비스가입사실 확인

상품을 검색중입니다.잠시만 기다려주세요.

OPEN API HOME>마이페이지>OPEN API

카테고리 상품의 카테고리 조회

GET 카테고리 리스트

HOST

HEADERS

PARAMS

GET 특정 카테고리 조회

HOST

HEADERS

PARAMS

Example Response

상품 상품 조회 및 관리 상품API문서 다운로드

POST 상품등록 (공급사회원전용)

HOST

HEADERS

PARAMS

Example Request

POST 상품수정 (공급사회원전용)

HOST

HEADERS

PARAMS

GET 상품목록조회

HOST

HEADERS

PARAMS

GET 특정상품조회

HOST

HEADERS

PARAMS

Example Response

주문 주문 등록 및 조회

POST 주문등록

HOST

HEADERS

PARAMS

Example Request

GET 주문목록조회

HOST

HEADERS

PARAMS

GET 특정주문조회

HOST

HEADERS

PARAMS

Example Response

GET 특정주문번호조회

HOST

HEADERS

PARAMS

Example Response (주문서에 하나의 주문이 있는 경우)

Example Response (주문서에 여러 주문이 있는 경우)

POST 특정주문취소

HOST

HEADERS

PARAMS

Example Request

GET 공급사 주문목록조회 (공급사전용)

HOST

HEADERS

PARAMS

GET 공급사 특정주문조회 (공급사전용)

HOST

HEADERS

PARAMS

Example Response

POST 특정주문취소 (공급사전용)

HOST

HEADERS

PARAMS

Example Request

PATCH 배송정보업데이트 (공급사전용)

HOST

HEADERS

PARAMS

Example Request

에스크로 구매안전서비스

상품을 검색중입니다.
잠시만 기다려주세요.

OPEN API
HOME>마이페이지>OPEN API