Unlock Icon ¡Desbloquea ahorros exclusivos! Inicie sesión o regístrese ahora para acceder a mejores precios.
help desk software

Getting Started

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

Authentication

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. Navigate to your customer profile
  2. Log in to your Online Components account and go to your customer profile

  3. Go to API Access and Services
  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. Request Your API Key
  6. Request an API key from this section, choosing between a production or a sandbox API key. You'll receive your key instantly. If you suspect any security issues, you can retrigger and regenerate your key at any time


Sandbox Environment

We understand the importance of testing before going live. That's why we provide a fully functional sandbox environment where you can experiment with all of our APIs without affecting your production data.

Accessing the Sandbox

  1. Requesting a Sandbox API Key
  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. Different Base URL
  4. While the API endpoints remain the same, the sandbox environment uses a different base URL.

    1. https://api.onlinecomponents.com
    2. https://sandbox.onlinecomponents.com
  5. Sandbox Developer Portal
  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

Description

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 offers faster processing with cleaner response data
  • Data formatting is cleaner and easier to display in modern browsers
  • API version control: Requests and responses are available in either JSON or XML

Features

  • Instant Access
  • Search by Keyword Method
  • Search by Part Number Method
  • Up to 50 results returned per call
  • Up to 100 calls per minute
  • Up to 100,000 calls per day

Data Available

  • Product Id
  • Part Number
  • Manufacturer Name
  • Description
  • Datasheet Url
  • Part Image
  • Product Url
  • Part Image
  • Quantity Available
  • quantityAvailableTxt
  • On Order Quantity
  • Factory Stock Quantity
  • Factory Lead Time
  • isDuplicateStock
  • 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
  • HBR
  • Available less than min
  • Alternative Parts
  • Prices

Endpoints

Order API

Gain access to the Onlinecomponents.com checkout process and order parts inside your own applications.

Description

The Order API can be used to place and check orders from Onlinecomponents.com It is intended to be used in conjunction with the Pricing and Availability API. We have a new version of Order API that is faster and more flexible:

  • JSON offers faster processing with cleaner response data
  • Data formatting is cleaner and easier to display in modern browsers
  • API version control: Requests and responses are available in either JSON or XML

Endpoints

The Order API can be used to place and check orders from Onlinecomponents.com It is intended to be used in conjunction with the 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

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"
    }]
}

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

 

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

Gain access to the Onlinecomponents.com checkout process and order parts inside your own applications.

Description

The Order API can be used to place and check orders from Onlinecomponents.com It is intended to be used in conjunction with the Pricing and Availability API. We have a new version of Order API that is faster and more flexible:

  • JSON offers faster processing with cleaner response data
  • Data formatting is cleaner and easier to display in modern browsers
  • API version control: Requests and responses are available in either JSON or XML

Endpoints

The Order API can be used to place and check orders from Onlinecomponents.com It is intended to be used in conjunction with the Pricing and Availability API.