Inspection API
본 문서는 주식회사 매스어답션에서 제공하는 블록체인(NFT) 기반의 디지털 보증 솔루션 연동에 관한 기술문서입니다. API 서비스는 허가된 사용자만 이용이 가능합니다. 사용 요청은 버클 홈페이지(https://partners.vircle.co.kr)의의) 도입문의 또는 [email protected] 로 문의주시기 바랍니다.
* 적용일자: 2022년 10월 1일 * 작성자: 김현태 ([email protected])
버클 명품감정 서비스 소개
버클 명품감정 서비스는 소비자가 상품 구매 시 명품감정을 신청한 경우 전문 파트너 감정사의 실물 감정을 진행합니다.
감정 완료 후 해당 상품이 정품일 경우, 상품 배송완료 후 정품임을 보증하는 디지털 보증서가 발행됩니다.
만약 해당 상품에 디지털 보증서가 이미 발급된 경우에는 추가 발급 없이 감정 이력만 추가됩니다.
해당 상품이 가품일 경우에는 가품 소견서가 제공되며 결제취소 및 환불 처리 등의 후속 절차가 필요합니다.
감정 신청 시 별도의 제3자 정보제공 동의 절자를 거쳐야합니다.
감정 진행상태 참고
View More
state
text
comment
3
감정신청
감정비 결제 후 감정 신청이 완료된 상태입니다.
4
입고완료(감정중)
감정센터에서 상품을 입고 완료 후 감정을 진행중인 상태입니다.
7
감정완료
감정사가 감정결과를 제출한 상태입니다. (출고 전까지 감정 결과가 수정될 수 있습니다)
8
출고완료
감정사가 상품을 출고완료한 상태입니다. (배송정보 조회 가능)
9
배송완료
최종 소비자가 상품 수령을 완료한 상태입니다.
19
신청취소
신청 기업이 상품 출고 전 신청을 취소한 상태입니다.
20
고객취소
사용자의 요청에 의해 상품 출고 전 신청을 취소한 상태입니다.
22
신청취소(검수불가)
감정불가 등의 사유로 감정센터에 상품 입고 후 신청이 취소된 상태입니다. (이후 Mall 에서 주문 취소 및 회수 절차를 진행해야합니다)
23
취소 후 출고
신청취소(22) 이후 회수 출고된 상태입니다.
24
취소 후 배송완료
신청취소(22) 이후 회수 완료된 상태입니다.
인증 (Authentication)
공통 에러
Unauthorized는 호출하는 API 종류에 상관없이 인증 시스템이 정상적으로 실행되지 않으면 발생합니다.버클 API는 표준 REST API와 같은 토큰 기반 인증을 사용합니다. 모든 요청은 반드시 올바른 Authorization 헤더를 가져야 합니다.
할당 받은 API 키(VIRCLE_API_KEY)를
X-Vircle-API-Key로, 클라이언트 암호(VIRCLE_API_SECRET)를Authorization로 사용하여 자격증명을 생성합니다.계정 보안을 위해 해당 키와 암호는 타인과 함부로 공유하지 말고 외부에 노출되지 않도록 보관합니다.
-
401: Unauthorized
Code
Message
UNAUTHORIZED_ERROR
API 인증정보를 확인할 수 없습니다.
UNAUTHORIZED_ERROR
파트너 정보를 조회할 수 없습니다.
API 목록
감정 가능 브랜드 목록감정비 계산기감정 신청(선감정)감정 상세조회감정 목록조회감정 신청취소Last updated