Order API
설명
Order API 덕분에 사용 중인 애플리케이션 내에서 그대로 마우저에 제출할 주문서를 작성하실 수 있습니다. 주문 시 마우저 부품 번호를 사용해야 하기 때문에, Mouser Search API로 주문 목록을 작성하는 것을 권장합니다. 아래에서 Order API에 관한 설명과 문서를 찾을 수 있습니다.
API 키 생성하기
My Mouser 계정 내에 API라는 새로운 섹션이 있으며, 해당 섹션에서 API 키를 신청하고 확인할 수 있습니다.
키 생성하기Order API 사용하기
Order API를 사용하면 주문 세부 정보에서 지원 국가, 주, 통화 등을 확인하고, 주문서를 제출할 수 있습니다.
Cart API와 마찬가지로, 단가 책정 및 주문 방법은 귀하의 계정과 기본 배송 주소, 또는 API 요청과 함께 보낸 배송 주소와 관련된 청구 주소를 기준으로 결정됩니다.
마우저의 API를 사용할 경우 권장되는 절차는 아래와 같습니다.
My Mouser 계정이 없는 경우 계정을 생성합니다.
API 키가 없을 경우 API 키를 생성합니다. My Mouser 계정에서 API 관리 페이지를 방문하여 이 작업을 수행할 수 있습니다.
마우저의 API를 활용한 주문 처리 방법을 확인하고, 당사에서 제공하는 단계별 API 가이드의 샘플 코드를 활용해보세요.
가이드 읽기모든 API와 각 API의 엔드포인트가 나열되어 있으며, API 요청을 수행할 수 있는 손쉬운 테스트 영역을 제공하는 API 탐색기 페이지를 방문하세요.
API 탐색기 방문하기요청 만들기
주문 제출하기
엔드포인트
Order API는 아래와 같이 엔드포인트를 제공합니다.
/options/query 엔드포인트는 청구 및 배송 주소, 통화 코드, 배송 방법, 요율, 결제 방법, 화물 운송 계정, 납세 관련 서류, VAT 계정, 귀하의 계정에 저장된 신용카드에 관한 정보를 나타냅니다.
options/query 엔드포인트를 사용하려면 청구지 및 배송 주소가 필요합니다.
귀하의 계정에 저장된 신용카드가 있는 경우에만 Order API에서 지원됩니다. 저장된 카드를 관리하려면 여기로 이동하세요.
청구지/배송 주소 기준으로 사용 가능한 모든 통화를 나타냅니다. /currencies 엔드포인트를 사용하려면 청구지 및 배송 주소가 필요합니다.
배송 국가 코드를 입력하면 귀하의 계정에 명시된 기본 배송 주소보다 우선시될 수 있습니다.
주문서를 제출하려면 해당 주문에 대한 통화 코드를 전송해야 합니다. 아래 이미지에 보이는 바와 같이, 내 주문을 미국 달러로 진행하고 싶은 경우 미국 달러에 해당하는 3자리 ISO 코드 값을 입력해야 합니다.
사용 가능한 모든 국가와 해당 국가에 있는 시/도를 나타냅니다. 사용자가 국가 코드로 국가를 필터링할 수 있도록 허용합니다. 주문서를 제출하고 귀하 계정의 기본 배송 주소를 업데이트하고 싶을 때 해당 엔드포인트를 통해 나타나는 결과값을 사용할 수 있습니다.
예를 들어, 애리조나로 배송하고 싶다면 주 ISO 코드는 'AZ'로, 국가 ISO 코드로 'US'로 설정하여 주문서를 제출합니다.
이 엔드포인트를 사용하여 새 주문서를 제출합니다. 앞서 언급한 대로, 여기서 생성되는 모든 주문은 귀하의 계정에 대해 이루어지며 주문서를 제출하기 전에 장바구니를 생성해야 합니다.
청구 주소/배송 주소/배송 방법/결제/국가 또는 통화/예정된 릴리즈에 오류가 있으면 주문서를 제출할 수 없습니다. 오류가 있는지 알고 싶다면 Fault Tolerance에 관한 섹션을 참조하세요.
장바구니 품목에 오류가 있는 경우 오류를 수정하거나 장바구니 품목을 제거한 후 주문서를 제출해야 합니다.
주문이 완료되면 주문 번호가 나타납니다.
'SubmitOrder' 속성이 true로 설정되어 있는 경우 기존 주문에서 새 주문을 제출합니다. 'SubmitOrder' 속성이 false로 설정되어 있는 경우에는 주문 요약이 나타납니다.
생성한 주문에 대한 세부 정보를 보려면 이 엔드포인트를 사용하세요. 이 쿼리를 사용하려면 주문 번호를 입력해야 하며, 해당 번호는 주문 생성에 사용된 엔드포인트 /api/v{version}/order에 대한 응답 내용에 나타납니다.