상단배너

  • 즐겨찾기에 추가

전체 카테고리


사이드 카테고리


XML 연동 도움말

상품의 API 연동을 위해 상품 DB의 일부를 XML화하는 서비스입니다.

사용법

상품 API 연동을 위한 XML 호출용 URL은 http://www.domebookmark.com/goods/goods_xml.php입니다.

단독으로는 이용할 수 없고 URL 호출시 아래 표에 기재된 파라미터를 함께 전송하여 사용합니다.

memid 회원 ID (필수)
apikey API 키 (필수)
recent 최근 n일 내 수정된 상품 보기
예: 1로 설정시 API 호출 시점으로부터 1일 전 0시 이후 수정된 상품 데이터 추출 (매진/삭제 포함)
-1로 설정시 수정일에 관계없이 모든 상품 데이터 추출 (매진/삭제 미포함)
priceratio 판매가율 설정
소수점 둘째 자리까지(예: 1.5, 2, 2.25 등) 입력 가능, 원단위는 절사 (예: 3,555원 → 3,550원)
limit 최대 표시 수
데이터가 너무 많을 경우 표시되는 데이터 수를 제한하기 위한 파라미터입니다. (생략시 100)
offset 오프셋
데이터가 너무 많아서 표시 개수를 제한할 때 처음 몇 개를 건너뛰고 표시할 것인지를 설정합니다.
예를 들어, 처음 100개를 가져온 후 다음 100개를 가져오고자 할 때 이 값을 100으로 설정합니다.

상기의 파라미터와 함께 XML 연동 URL을 호출하면 다음과 같은 형식의 XML 데이터가 생성됩니다.

<?xml version="1.0" encoding="utf-8"?>
<goodsinfo>
    <goods>
        <code>kd1234567890123_012</code>
        <category>
            <catcode>001002003</catcode>
            <catname>대분류 - 중분류 - 소분류</catname>
        </category>
        <name>상품명</name>
        <image>대표 이미지 URL</image>
        <addinfo>
            <maker>한국산업</maker>
            <origin>한국</origin>
        </addinfo>
        <price>
            <cost>1000</cost>
            <consumer>1200</consumer>
            <retail>2000</retail>
        </price>
        <delivery>2500</delivery>
        <options>
            <option cost="0" retail="0" sell="yes">첫 번째 옵션</option>
            <option cost="100" retail="200" sell="yes">두 번째 옵션</option>
        </options>
        <description><![CDATA[ 상품 설명 ]]></description>
        <tax>yes</tax>
        <update>
            <regdate>2017-01-01 10:00:00</regdate>
            <moddate>2017-02-01 12:00:00</moddate>
            <selling>yes</selling>
            <soldout>no</soldout>
            <restock>no</restock>
            <deleted>no</deleted>
        </update>
    </goods>
    <goods>
        ...
    </goods>
    ...
</goodsinfo>

위와 같이 goodsinfo 아래에 goods라는 요소가 생성됩니다. goods 요소는 조건에 맞는 상품 수만큼 생성됩니다.

goods 요소 아래에 생성되는 요소들은 다음과 같습니다.

code 자체상품코드
category 카테고리 사항
catcode 자체 카테고리 코드
catname 카테고리 이름
name 상품명
image 대표 이미지 URL
addinfo 추가정보
maker 제조사
origin 원산지
price 가격정보
cost DOME즐겨찾기 공급가
consumer 소비자가 (해당 상품이 가격준수상품으로 지정된 경우에 한하여 생성)
retail 판매가 (priceratio 파라미터 설정에 따라 결정)
delivery 배송비
options 옵션정보 (옵션이 있을 경우 이 요소 안에 option 요소가 그 수만큼 생성되며 옵션이 없을 경우 비워집니다.)
option 상품의 옵션 이름. 다음과 같은 속성값이 추가됩니다.
  • cost: DOME즐겨찾기 공급가
  • retail: 판매가 (priceratio 파라미터 설정에 따라 결정)
  • sell: 해당 옵션을 판매중인지의 여부 (yes: 판매중, no: 판매안함)
description 상품 설명
tax 과세여부 (yes: 과세, no: 비과세, free: 면세)
update 상품 업데이트 사항
regdate 상품 등록일
moddate 상품 수정일
selling 판매여부 (yes: 판매함, no: 판매중단)
(※주의: 이 요소는 품절여부에 종속된 요소가 아닌 별개의 요소입니다.)
soldout 품절여부 (yes: 품절, no: 재고있음)
restock 재입고여부 (yes: 재입고됨, no: 재입고안됨)
deleted 삭제여부 (yes: 삭제, no: 유지)
상품DB API 연동
장바구니
최근본상품
0/0
자동연동프로그램
도매즐겨찾기X셀러윈