订单API

实现您在贸泽下单流程的自动化

概述

需要帮助?

如有任何问题,请随时联系我们,我们将竭诚为您服务。

立即联系贸泽

说明

订单API允许您在不离开应用程序的情况下向贸泽下单。由于需要使用贸泽元器件编号,因此建议您利用贸泽搜索API建立订单列表。下文为您详细介绍了订单API并提供了相关文档。

生成API密钥

“My Mouser帐户”中有一个名为API的版块,您可以在这里注册和查看API密钥。

生成密钥

使用订单API

借助于订单API,您能够查看每个订单的详细信息,获取受支持的国家/地区、州/省和币种列表,而且还能提交订单。

类似于购物车API,报价和订购规则均基于绑定到您帐户的账单地址以及默认收货地址或随API请求发出的收货地址来确定。

使用贸泽API时,建议遵循以下操作步骤:

  1. 如果您没有“My Mouser帐户”,请先创建一个。

  2. 如果没有API密钥,您可以登录“My Mouser帐户”,在API管理页面生成密钥。

  3. 了解如何使用贸泽API,并通过访问我们的API分步指南来获取示例代码。

    阅读指南
  4. 访问API Explorer页面,这里列出了所有可用API以及每种API的端点,并提供了一个简单易用的测试区域便于您发出API请求。

    访问API Explorer
  5. 创建请求

  6. 提交订单

端点

订单API包含以下端点。

“/options/query”端点将返回您的账单和收货地址、货币代码、运输方式列表和费率、付款方式、运费清单、税收证明、增值税账户以及已保存的信用卡信息。

使用“options/query”端点,需提供账单和收货地址。

仅当帐户中保存了信用卡时,订单API才可以支持信用卡。要管理已保存的银行卡,请转到这里。

基于您的账单/收货地址返回所有可用币种。使用“/currencies”端点,需提供账单和收货地址。

可以提供收货国家/地区代码来覆盖您帐户中的默认收货地址。

要提交订单,您需要发送该订单相应的货币代码。如下图所示,如果我希望为订单选择美元币种,则应发送三位数ISO代码值USD。

返回所有可用的国家/地区,以及该国家/地区下属的任何州/省信息。允许用户使用国家/地区代码来筛选国家/地区。在提交订单或是想覆盖帐户中的默认收货地址时,可使用该端点返回的值。

例如,如果收货地址是亚利桑那州,在提交订单时,则应发送“AZ”作为州ISO代码、“US”作为国家ISO代码。

使用此端点来提交新订单。如前所述,任何在此创建的订单将对照您的帐户下单,在提交订单前需要先创建一个购物车。

如果在账单地址/送货地址/送货方式/付款/国家/地区或货币/排期放行方面存在错误,您将不能提交订单。如果您不确定是否存在错误,请参阅“容错”部分。

如果任何购物车项目有错,您将需要在提交订单前更正错误或删除该购物车项目。

如果成功下单,将会返回订单编号。

如果“SubmitOrder”属性设置为true,则用旧订单下单。如果"SubmitOrder"属性设置为false,则返回订单摘要。

使用此端点查看所建订单的详细信息。要使用此查询功能,需提供“/api/v{version}/order”端点返回的订单编号。