*개인정보 처리 방침*
|
|
 |
|
|
|
API 회원가입
옥션 API 를 이용하기 위해서는, 옥션 아이디와는 별도로 개발자프로그램 아이디(DevID) / AppID / 인증티켓이 필요합니다.
옥션 API 이용절차
- 개발자프로그램ID 등록
- AppID등록
- 인증티켓 발급
- API 연동
1. 개발자프로그램 ID(DevID)등록하기
개발자프로그램 ID는 옥션개발자프로그램 사이트 우측 상단의 회원가입 페이지를 통한 회원가입으로 등록 하실 수 있습니다.
개발자프로그램 ID는 API이용시, 연동에 사용되는 AppID및 인증티켓을 발급 받는데 반드시 필요합니다. (옥션 ID와 별도)
2. AppID등록하기
개발자프로그램 사이트 회원가입 후, 로그인을 하시면 우측 상단 회원정보수정 페이지에서 AppID를 등록하실 수 있습니다.
-
1) 회원정보수정페이지 하단 AppID발급 목록에 있는 추가버튼을 클릭합니다.
-
2) API Application 정보등록 페이지에서 각 항목을 기재하신 후, 등록확인 버튼을 클릭하시면 AppID 발급이 완료됩니다.
(AppID는 개발자 프로그램 ID와는 별도로 반드시 등록이 필요합니다.)
-
3) 회원정보수정 페이지 하단, AppID 발급목록에서 등록하신 AppID 확인이 가능하며, 목록에 있는 AppID를 클릭하시면
AppID 정보수정이 가능합니다.
3. 인증티켓 발급받기
마지막으로, AppID를 등록하신 후에는 API연동에 필요한 인증티켓을 발급 받으셔야 합니다.
인증티켓은 좌측 메뉴의 “옥션회원 인증티켓 발급” 페이지에서 발급 받으실 수 있습니다.
인증티켓 발급 시에는 AppID와 옥션 일반회원 ID가 필요하며, 인증 유효기간이 설정되어 있기 때문에 발급 후 유효기간이
경과하면 인증티켓을 재발급 받아야 합니다.
(인증 유효기간: 최장 90일 / 단, AppID와 옥션 일반회원 ID가 같을 경우에는 1년까지 유효)
API 연동테스트
실제 개발 연동에 앞서, 옥션에서 제공하는 웹페이지와 어플리케이션을 통해 API 연동 테스트를 진행 하실 수 있습니다.
API 연동 테스트는 간단한 XML 메시지 입력을 통해 확인 하실 수 있습니다. (테스트 및 연동 시 인증티켓 필수)
어플리케이션으로 테스트하기
옥션에서 제공하는 별도의 어플리케이션을 통해서도, API 연동 테스트를 진행 하실 수 있습니다.
어플리케이션을 다운(클릭) 받으신 후, 설치합니다.
설치 완료 된 어플리케이션(API TEST TOOL)을 실행합니다.
- 1) 발급 받으신 인증 티켓을 입력합니다. (우측의 티켓저장 버튼으로 입력값 저장 가능)
- 2) 제공하는 함수의 XML Request 전문을 입력합니다.
- 3) 함수가 포함되어 있는 서비스 URL을 선택합니다.
- 4) API 호출 버튼을 클릭합니다.
- 5) Response 전문으로 결과값을 확인합니다. (오류내용 포함)
API 이용
API를 이용한 판/구매 행위는 옥션사이트에서 판/구매를 하는 것과 똑같이 결과를 낳습니다.
따라서 테스트 삼아서 API를 Call하더라도 수수료가 과금되거나 판/구매 거부에 따른 불이익이 발생할 수 있습니다.
서버 정보
| 실제서버 |
- http://api.auction.co.kr/APIv1/Auctionservice.asmx
- http://api.auction.co,kr/APIv1/Shoppingservice.asmx(Sell v3)
|
API 로 상품등록/수정
옥션 API에서 제공하는 함수를 통해, 옥션 사이트에 실제 상품 등록/수정을 하실 수 있습니다.
[1]상품등록
옥션 API ShoppingService의 3가지 함수(AddItem, ReviseItemStock, ReviseItemSelling) 호출을 통해
상품등록(판매)이 가능합니다.
※API를 활용한 상품등록(판매) 시, 함수 호출 순서
-
AddItem
함수 호출
-
ReviseItemStock
함수 호출
-
ReviseItemSelling
함수호출
-
1) AddItem : 상품정보 등록(고정가 물품 정보 등록)
-
2) ReviseItemStock : 상품 재고수량 등록(주문선택사항,추가구성물품 설정)
-
3) ReviseItemSelling : 판매정보(판매기간, 판매상태) 등록
※함수 호출 시 상태 변화 안내
- 1) Additem 함수 호출 :
- 경매번호 생성완료 → 옥션판매관리 고정가물품관리 일괄등록 메뉴에서 확인 가능
- 2) ReviseItemStock 함수 호출 :
- 재고정보 등록 완료(선택사항,추가구성물품) → 옥션판매관리 고정가물품관리 일괄등록 메뉴에서 확인 가능
- 3) ReviseItemSelling 함수 호출 :
- 판매상태 등록 완료(판매중/판매중지) → 옥션판매관리 고정가물품관리 물품조회/수정 메뉴에서 확인 가능
[2]상품수정
옥션 API ShoppingService의 ReviseItem 함수를 사용하여, 등록 되어있는 상품의 정보수정이 가능합니다.
※이 외에도 옥션에서 제공하는 여러 API 함수를 통해, 검색/배송/결제정보 조회 등의 기능 연동이 가능합니다.
단, 일부 함수의 경우에는 별도 제휴계약을 통한 권한 부여를 받은 후에 사용하실 수 있습니다.
API 함수안내
옥션에서는 일반 개발자와 일반 개발 회사를 대상으로 다음과 같은 API Service (APIV1) 를 제공합니다.
아래에 제공되는 서비스 URL을 클릭하시면, 해당 서비스에 제공되는 함수명과 기능명세 및 각 함수 별 WSDL 전문을
확인 하실 수 있습니다
옥션 API ShoppingService의 3가지 함수(AddItem, ReviseItemStock, ReviseItemSelling) 호출을 통해
상품등록(판매)이 가능합니다.
[APIv1 : 일반 개발자 / 사용자 대상 OPEN API]
- http://api.auction.co.kr/APIv1/AuctionService.asmx
- http://api.auction.co.kr/APIv1/ShoppingService.asmx
- http://api.auction.co.kr/APIv1/SecurityService.asmx
위의 3가지 서비스와 별도로, Partner용 API인 ArcheSystem Service를 추가로 제공하는데,
이는 옥션과 특수한 관계에 있고, 별도 계약에 의해서 시스템간 서비스 통합 및 연동에 사용되는 API입니다.
이 API들은 회원 정보, 포인트, 이머니 등 민감한 정보를 다루는 서비스를 포함하고 있기 때문에, 일반 개인 개발자
또는 제휴사에 권한 부여에 제약이 있습니다.
[ArcheSystem : 특수 관계사 및 제휴사 대상 OPEN API]
- http://api.auction.co.kr/ArcheSystem/MainService.asmx
- http://api.auction.co.kr/ArcheSystem/SecurityService.asmx
각 서비스에서 제공하는 함수에 대한 기본 설명 및 함수내부의 사용되는 element 정의는 좌측메뉴의
“개발 레퍼런스 통합검색” 페이지를 통해, 상세 검색이 가능합니다.
개발레퍼런스 통합검색 메뉴 이용 Tip!!
개발레퍼런스 통합검색
- 함수명으로 검색하고자 할 때 :
- (1) Name으로 설정하고, 검색창에 함수명을 입력 후 검색합니다. (부분입력 가능 / 예: Item)
- 특정 기능에 대한 함수를 검색하고자 할때 :
- (1) Description으로 설정하고, 검색창에 찾고자하는 단어를 입력 후 검색합니다. (예: 배송, 결제)
옥션 API 기능별 제공 함수 리스트 [각 함수명(영문)을 클릭하시면 WSDL 전문을 보실 수 있습니다]
|
|
|
|
