訂單API
描述
訂單API讓您可以在應用程式內直接向貿澤下訂單。由於我們需要您使用貿澤零件編號，建議您透過貿澤搜尋API建立訂單清單。以下是關於訂單API的說明與文檔。
生成API密鑰
在您的My Mouser帳號內，新增了一個名為API的專區，您可以在此註冊並查看您的API密鑰。
生成密鑰使用訂單API
訂單API讓您能夠檢視訂單詳細資料，取得所支援國家/地區、州、貨幣清單，最重要的是能夠提交訂單。
如同購物車API，定價與訂單規則是根據您帳號關聯的帳單地址，以及預設送貨地址或隨API請求傳送的送貨地址來決定。
以下是使用一款貿澤API時建議採取的步驟：
如果您還沒有My Mouser帳號，請先建立一個。
如果您沒有API密鑰，請生成一個。您可以造訪My Mouser帳號中的API管理頁面來創建。
透過我們逐步API指南，深入了解貿澤API的詳細流程，並取得範例程式碼。
閱讀指南造訪API Explorer頁面。該頁面列出了所有可用的API、各個API的端點，並提供易於使用的測試區域供您發送API請求。
造訪API Explorer建立請求
提交訂單
端點
訂單API提供下列端點：
/options/query端點將返回您的帳單與送貨地址、貨幣代碼、送貨方式清單及相關費率、付款方式、貨運帳戶、稅務證明、增值稅帳戶，以及您帳號中儲存的信用卡資料。
使用options/query端點時，需要提供帳單與送貨地址。
僅當您的帳號內已儲存信用卡資料時，訂單API才會支援信用卡支付功能。要管理已儲存的銀行卡，請前往此處。
按照您的帳單/送貨地址返回所有可用的貨幣。使用/currencies端點時，需要提供帳單與送貨地址。
可以提交送貨國家代碼來覆寫您帳號上的預設送貨地址。
要提交訂單，您需要提供該訂單的貨幣代碼。如下圖所示，如果我想為訂單選擇美元 (USD) 貨幣，則需傳送美元 (USD) 的3位數ISO代碼值。
返回所有可用的國家，及該國家的所有州/省。允許用戶透過國家代碼篩選國家。若您提交訂單並需要覆寫帳號上的預設送貨地址，可使用此端點返回的值。
例如，如果我想運送到亞利桑那州，我會將「AZ」作為州ISO代碼，將「US」作為國家ISO代碼來提交訂單。
使用此端點提交新的訂單。如前所述，在此處創建的任何訂單都將計入您的帳號，在提交訂單前需先創建購物車。
如果帳單地址/送貨地址/送貨方式/付款/國家或貨幣/計畫發布日期存在任何錯誤，您將無法提交訂單。如果您不確定是否發生錯誤，請參閱容錯處理的相關章節。
如果購物車中任何商品出現錯誤，您需要在提交訂單前更正錯誤或移除該商品。
如果成功提交訂單，系統將返回訂單編號。
如果「SubmitOrder」屬性設定為True，就從舊訂單提交新訂單。如果「SubmitOrder」屬性設定為False，就返回訂單摘要。
使用此端點查看您所建立的訂單詳細資料。要使用查詢功能，您必須提供訂單編號，該編號會回傳創建訂單所用端點（/api/v{version}/order）的響應主體。