入门指南
歡迎來到 Master Electronics API 套件!請依照以下步驟開始:
身份验证
要访问 Master Electronics APIs,您需要一个 API key。您可以从同一位置获取生产和沙盒 API keys:
- 導航至您的客戶資料
- 前往 API 存取和服務
- 請求您的 API 金鑰
登入您的 Master Electronics 帳戶並前往您的客戶資料
在客戶資料下,找到標示為「API 存取和服務」的部分。您也可以直接點選此處造訪API接入與服務頁面
添加新分支
沙箱環境
我们了解上线前测试的重要性。因此,我们提供功能完整的沙盒环境,您可以在其中试用我们的所有 API,而不会影响您的生产数据。
访问 Sandbox
- 请求 Sandbox API 密钥
- 不同的基本 URL
- https://www.masterelectronics.com
- https://sandbox.masterelectronics.com
- 沙箱開發者門戶
从以下位置请求您的 Sandbox API Key:API 访问和服务 页面。此密钥不同于您的生产密钥,专门用于沙盒测试。
雖然 API 端點保持不變,但沙箱環境使用不同的基本 URL。
通过以下项访问沙盒环境 Sandbox 开发者门户 。在这里,您将找到所有必要的文档、工具和支持,帮助您有效测试集成
搜尋介面
Master Electronics 搜尋 API 是一種強大且簡單的方法,可在您自己的應用程式中存取和利用 Master Electronics 產品資料、可用性和定價
描述
搜尋 API 服務可讓客戶在自己的應用程式中利用 Master Electronics 的產品資料、可用性和定價。輕鬆搜尋超過 800 萬種產品和詳細的產品資訊。 JSON 資料格式現已可用於 Master Electronics 搜尋 API
-
我們有一個更快、更靈活的新版本搜尋 API:
- JSON 通过更清晰的响应数据提供更快的处理
- 数据格式更整洁,并且更易于在现代浏览器中显示
- API 版本控制:请求和响应可以使用 JSON 或 XML
特徵
- 标语
- 按關鍵字搜尋方法
- 按零件号方法搜索
- 每次呼叫最多回傳 50 個結果
- 每分鐘最多 100 次呼叫
- 客户电话#
可用數據
- Product Id
- Part Number
- Manufacturer Name
- Description
- Datasheet Url
- Part Image
- Product Url
- Quantity Available
- On Order Quantity
- Factory Stock Quantity
- Factory Lead Time
- Availability
- Package Quantity
- Package Cross Quantity
- Product Sub Category
- Product Status
- RoHS
- Min Order Quantity
- Package Type
- Package Cross
- Multiple
- Unit Of Measure
- COO
- ECCN
- PRC
- HTS
- Main Category
- Sub Category
- Taxonomy
- Product Life Cycle
- Available less than min
- Alternative Parts
- Prices
端點
订单 API
获得对 Master Electronics 结账流程的访问权限,并在您自己的应用程序中订购零件。
描述
Order API 可用于向 Master Electronics 下单并检查订单。它旨在与 Pricing and Availability API 结合使用。我们有一个更快、更灵活的新版本 Order API:
- JSON 通过更清晰的响应数据提供更快的处理
- 数据格式更整洁,并且更易于在现代浏览器中显示
- API 版本控制:请求和响应可以使用 JSON 或 XML
端點
Order API 可用于向 Master Electronics 下单和检查订单。它旨在与 Pricing and Availability API 配合使用。
请求参数
| 参数 | 描述 | 必填 |
|---|---|---|
| 电子邮件 | 是 | |
| firstName | 名字 | 是 |
| lastName | 姓氏 | 是 |
| phoneNumber | 电话号码 | 是 |
| shippingMethod | 是 | |
| accountNo | 运输账户号码 | 是 |
| carrier | 否 | |
| shippingInsurance | 是 | |
| taxable | 是 | |
| resaleNumber | 否 | |
| shippingAddress | 送货地址 | 是 |
| shippingAddress.firstName | 名字 | 是 |
| shippingAddress.lastName | 姓氏 | 是 |
| shippingAddress.company | 公司 | 是 |
| shippingAddress.countryTwoletterISOCode | 国家/地区 | 是 |
| shippingAddress.stateProvinceAbbreviation | 州 | 是 |
| shippingAddress.city | 市 | 是 |
| shippingAddress.address1 | 地址 1 | 是 |
| shippingAddress.address2 | 地址 2 | 是 |
| shippingAddress.zipPostalCode | 邮编 / 邮政编码 | 是 |
| shippingAddress.phoneNumber | 电话号码 | 是 |
| billingAddress | 4. 输入应用的名称并点击 | 是 |
| billingAddress.firstName | 名字 | 是 |
| billingAddress.lastName | 姓氏 | 是 |
| billingAddress.company | 公司 | 是 |
| billingAddress.countryTwoletterISOCode | 国家/地区 | 是 |
| billingAddress.stateProvinceAbbreviation | 州 | 是 |
| billingAddress.city | 市 | 是 |
| billingAddress.address1 | 地址 1 | 是 |
| billingAddress.address2 | 地址 2 | 是 |
| billingAddress.zipPostalCode | 邮编 / 邮政编码 | 是 |
| billingAddress.phoneNumber | 电话号码 | 是 |
| paymentMethod | 付款方式 | 是 |
|
CustomerPoNumber
|
no | |
| orderComment | 订单备注 | 否 |
| orderItem | 是 | |
| orderItem.productId | 订单行项目标识符 | 是 |
| orderItem.partNumber | 否 | |
| orderItem.manufacturerName | 否 | |
| orderItem.quantity | 数量 | 是 |
| orderItem.price | 价格 | 否 |
| orderItem.customerpartnumber | 客户零件编号 | 否 |
| currencycode | 货币代码 | 否 |
请求示例
{
"email": "string",
"firstName": "string",
"lastName": "string",
"phoneNumber": "string",
"shippingMethod": "string",
"accountNo": "string",
"carrier": "string",
"shippingInsurance": true,
"taxable": true,
"resaleNumber": false,
"shippingAddress": {
"firstName": "string",
"lastName": "string",
"company": "string",
"countryTwoletterISOCode": "string",
"stateProvinceAbbreviation": "string",
"city": "string",
"address1": "string",
"address2": "string",
"zipPostalCode": "string",
"phoneNumber": "string"
},
"billingAddress": {
"firstName": "string",
"lastName": "string",
"company": "string",
"countryTwoletterISOCode": "string",
"stateProvinceAbbreviation": "string",
"city": "string",
"address1": "string",
"address2": "string",
"zipPostalCode": "string",
"phoneNumber": "string"
},
"paymentMethod": "string",
"customerponumber": "string",
"orderComment": "string",
"orderItem": [{
"productId": 0,
"partNumber": "string",
"manufacturerName": "string",
"quantity": 0,
"price": 0,
"customerpartnumber": "string"
}],
"currencycode": "string",
}
响应示例
{
"orderId": "string",
"errors": [
"string"
],
"success": true
}
可用的配送方式
国内配送选项
| 承运商代码 | 服务代码 |
|---|---|
| UPS | UPS Ground |
| UPS | UPS 3rd Day |
| UPS | UPS 2nd Day |
| UPS | UPS Next Day Saver |
| UPS | UPS Next Day |
| UPS | UPS Next Day Early |
| FEDEX | FedEx Ground |
| FEDEX | FedEx 3rd Day |
| FEDEX | FedEx 2nd Day |
| FEDEX | FedEx Priority Overnight |
| FEDEX | FedEx Std Overnight |
国际配送选项
| 承运商代码 | 服务代码 |
|---|---|
| UPS | UPS World Wide Express |
| UPS | UPS World Wide Saver |
| UPS | UPS World Wide Expedited |
| FEDEX | FedEx International Priority |
| FEDEX | FedEx International Economy |
可用的付款方式
| 付款方式名称 |
|---|
| Net30 |
| Net45 |
| Net60 |
| PrePayment |
| Net15 |
| Net75 |
| Net90 |
可用货币
| 货币 | 货币代码 |
|---|---|
| USD | usd |
可能出现的错误消息
以下列出了因 API 请求错误或未满足内部先决条件而可能返回的错误消息。
| 描述 |
|---|
| The minimum quantity allowed for purchase is |
| The maximum quantity allowed for purchase is |
| Allowed quantities for this product: |
| You may purchase all in-stock quantity of {0} or our minimum order quantity of {1} . Please adjust your quantity and add to cart to continue. |
| Quantity should be increments of |
| Minimum order quantity is |
| Please insert valid quantity |
| MOQ for out of Stock Qty is |
| Sorry, Item has no price, please contact us or submit price request |
| Sorry, Can not change quantity for this item |
| Sorry, we have limited Availability, please contact us or submit price request |
| Email is required |
| First Name is required |
| Last Name is required |
| Phone Number is required |
| Country Two letter ISO Code is required |
| Company is required |
| Address1 is required |
| City is required |
| Zip Postal Code is required |
| Please add valid data for item |
| Order Item is required |
| ShippingMethod is required |
| AccountNo is required |
| ship account should be 6 characters |
| ship account should be 9 characters |
| No Customer Found |
| no shipping address found |
| Shipping Address Error |
| Shipping Method Error |
| Error on Process Order |
| Payment Error |
| This product is no longer available, please modify your shopping cart |
订单历史 API
获得对 Master Electronics 结账流程的访问权限,并在您自己的应用程序中订购零件。
描述
Order API 可用于向 Master Electronics 下单并检查订单。它旨在与 Pricing and Availability API 结合使用。我们有一个更快、更灵活的新版本 Order API:
- JSON 通过更清晰的响应数据提供更快的处理
- 数据格式更整洁,并且更易于在现代浏览器中显示
- API 版本控制:请求和响应可以使用 JSON 或 XML
端點
Order API 可用于向 Master Electronics 下单和检查订单。它旨在与 Pricing and Availability API 配合使用。
English
中文 / 汉语
Deutsch
Español
Nederlands