사이드 카테고리
- 식품·생필품
- 잡화·뷰티·유아동
- 홈데코·문구·취미
- 컴퓨터·디지털·가전
- 스포츠·건강
- 자동차·공구
- BOX상품
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로 설정시 수정일에 관계없이 모든 상품 데이터 추출 (매진/삭제 미포함) |
new | 최근 n일 내 등록된 상품 보기 recent 대신 이 파라미터를 지정하면 최근 등록된 상품이 표시됩니다. |
priceratio | 판매가율 설정 소수점 둘째 자리까지(예: 1.5, 2, 2.25 등) 입력 가능, 원단위는 절사 (예: 3,555원 → 3,550원) |
limit | 최대 표시 수 데이터가 너무 많을 경우 표시되는 데이터 수를 제한하기 위한 파라미터입니다. (생략시 100) |
offset | 오프셋 데이터가 너무 많아서 표시 개수를 제한할 때 처음 몇 개를 건너뛰고 표시할 것인지를 설정합니다. 예를 들어, 처음 100개를 가져온 후 다음 100개를 가져오고자 할 때 이 값을 100으로 설정합니다. |
page | 페이지 데이터 오프셋을 페이지 단위로 지정해서 표시합니다. 이 파라미터는 offset 파라미터와 공존할 수 없습니다. 이 파라미터가 지정되면 offset 파라미터는 무시되고 자동으로 오프셋이 맞춰집니다. |
상기의 파라미터와 함께 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 | 상품의 옵션 이름. 다음과 같은 속성값이 추가됩니다.
|
|
description | 상품 설명 | |
tax | 과세여부 (yes: 과세, no: 비과세, free: 면세) | |
update | 상품 업데이트 사항 | |
regdate | 상품 등록일 | |
moddate | 상품 수정일 | |
selling | 판매여부 (yes: 판매함, no: 판매중단) (※주의: 이 요소는 품절여부에 종속된 요소가 아닌 별개의 요소입니다.) |
|
soldout | 품절여부 (yes: 품절, no: 재고있음) | |
restock | 재입고여부 (yes: 재입고됨, no: 재입고안됨) | |
deleted | 삭제여부 (yes: 삭제, no: 유지) |