はじめに

Welcome to the Online Components API Suite! Follow these steps to get started:

認証

To access the Online Components APIs, you'll need an API key. You can obtain both production and sandbox API keys from the same location:

  1. 顧客プロフィールに移動します
  2. Log in to your Online Components account and go to your customer profile

  3. API アクセスとサービスに移動
  4. Under the customer profile, locate the section labeled "API Access and Services." You can also directly click here to access the API Access and Services page

  5. APIキーをリクエスト
  6. 新しい支店を追加


サンドボックス環境

本番稼働前のテストの重要性を理解しています。そのため、本番データに影響を与えることなくすべての API を試せる、完全に機能する sandbox 環境を提供しています。

Sandbox へのアクセス

  1. Sandbox API キーのリクエスト
  2. Request your Sandbox API Key from the API Access and Services page. This key is distinct from your production key and is used exclusively for sandbox testing.

  3. 別のベース URL
  4. API エンドポイントは同じままですが、サンドボックス環境では別のベース URL が使用されます。

    1. https://api.onlinecomponents.com
    2. https://sandbox.onlinecomponents.com
  5. サンドボックス開発者ポータル
  6. Access the sandbox environment through the Sandbox Developer Portal. Here, you'll find all the necessary documentation, tools, and support to help you effectively test your integration

Search API

The Onlinecomponents.com Search API is a powerful, yet easy, way to gain access to and utilise Onlinecomponents.com product data, availability and pricing in your own applications

説明

The Search API service allows customers to utilise Onlinecomponents.com product data, availability, and pricing in their own applications. Search over 8 million products and detailed product information with ease. JSON Data Format is now available for Onlinecomponents.com Search API

    We have a new version of Search API that is faster and more flexible:
  • JSON はよりクリーンな応答データでより高速な処理を提供します
  • データ形式はより整理され、最新のブラウザーで表示しやすくなります
  • API バージョン管理: リクエストとレスポンスは JSON または XML で利用できます

特徴

  • タグライン
  • キーワードによる検索方法
  • Part Number による検索方法
  • 1 回の呼び出しで最大 50 件の結果が返されます
  • 1 分あたり最大 100 回の呼び出し
  • 顧客電話番号#

データあり

  • Product Id
  • Part Number
  • Manufacturer Name
  • Description
  • Datasheet Url
  • Product Url
  • Part Image
  • 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

Onlinecomponents.com のチェックアウトプロセスにアクセスし、ご自身のアプリケーション内で部品を注文できます。

説明

Order API は、Onlinecomponents.com で注文を行い確認するために使用できます。Pricing and Availability API と併用することを想定しています。より高速で柔軟な新バージョンの Order API があります:

  • JSON はよりクリーンな応答データでより高速な処理を提供します
  • データ形式はより整理され、最新のブラウザーで表示しやすくなります
  • API バージョン管理: リクエストとレスポンスは JSON または XML で利用できます

エンドポイント

Order API は、Onlinecomponents.com で注文を行い確認するために使用できます。Pricing and Availability API と組み合わせて使用することを意図しています。

Request Parameters

Parameter Description Required
email The email address of the customer to be associated to the sales order yes
firstName The first name of the customer yes
lastName The last name of the customer yes
phoneNumber The phone number for the order yes
shippingMethod   yes
accountNo Shipping account no. yes
carrier   No
shippingInsurance   yes
taxable   yes
resaleNumber   No
shippingAddress The shipping address for the order yes
shippingAddress.firstName The first name to be used for the ship-to address yes
shippingAddress.lastName The last name to be used for the ship-to address yes
shippingAddress.company The company name to be used for the ship-to address yes
shippingAddress.countryTwoletterISOCode The two character country code to be used for the ship-to address (e.g. US) yes
shippingAddress.stateProvinceAbbreviation The state or province to be used for the ultimate destination address yes
shippingAddress.city The city to be used for the ship-to address yes
shippingAddress.address1 The first address to be used for the ship-to address yes
shippingAddress.address2 The second address to be used for the ship-to address yes
shippingAddress.zipPostalCode The postal code to be used for the ship-to address yes
shippingAddress.phoneNumber The phone number to be used for the ship-to address yes
billingAddress The billing address for the order yes
billingAddress.firstName The first name to be used for the bill-to address yes
billingAddress.lastName The last name to be used for the bill-to address yes
billingAddress.company The company name to be used for the bill-to address yes
billingAddress.countryTwoletterISOCode The two character country code to be used for the bill-to address (e.g. US) yes
billingAddress.stateProvinceAbbreviation The state or province to be used for the ultimate destination address yes
billingAddress.city The city to be used for the bill-to address yes
billingAddress.address1 The first address to be used for the bill-to address yes
billingAddress.address2 The second address to be used for the bill-to address yes
billingAddress.zipPostalCode The postal code to be used for the bill-to address yes
billingAddress.phoneNumber The phone number to be used for the bill-to address yes
paymentMethod The payment method to pay for the order yes
CustomerPoNumber
  no
orderComment Comment of the currently selected order No
orderItem   yes
orderItem.productId The unique identifier for the order line item yes
orderItem.partNumber   No
orderItem.manufacturerName   No
orderItem.quantity The number of items purchased yes
orderItem.price Item unit price No
orderItem.customerpartnumber Customer Part Number No
currencycode Currency Code No

Example Request onlinecomponents.com

{
    "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",
}

Example Response onlinecomponents.com

{
    "orderId": "string",
    "errors": [
        "string"
    ],
    "success": true
}

Available Shipping Methods

Domestic Options

Agent Code Service Code
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

 

International Options

Agent Code Service Code
UPS UPS World Wide Express
UPS UPS World Wide Saver
UPS UPS World Wide Expedited
FEDEX FedEx International Priority
FEDEX FedEx International Economy

 

Available Payment Methods

Payment Method Name
Net30
Net45
Net60
PrePayment
Net15
Net75
Net90

 

Available Currency

Currency Currency Code
USD usd
EUR eur

 

Potential Error Messages

The following is a list of error messages that could be received as a result of an error in the API request or one of the onlinecomponents.com internal prerequisites not being completed.

Description
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

Order History API

Onlinecomponents.com のチェックアウトプロセスにアクセスし、ご自身のアプリケーション内で部品を注文できます。

説明

Order API は、Onlinecomponents.com で注文を行い確認するために使用できます。Pricing and Availability API と併用することを想定しています。より高速で柔軟な新バージョンの Order API があります:

  • JSON はよりクリーンな応答データでより高速な処理を提供します
  • データ形式はより整理され、最新のブラウザーで表示しやすくなります
  • API バージョン管理: リクエストとレスポンスは JSON または XML で利用できます

エンドポイント

Order API は、Onlinecomponents.com で注文を行い確認するために使用できます。Pricing and Availability API と組み合わせて使用することを意図しています。

回路に参加して、OnlineComponents.com とその先の情報につながり続けましょう!