Introdução
Bem-vindo ao Onlinecomponents.com API Suite! Siga estes passos para começar:
Autenticação
Para acessar as APIs do Onlinecomponents.com, você precisará de uma chave de API. Você pode obter chaves de API de produção e sandbox no mesmo local:
- Navigate to your cliente profile
- Ir para Acesso à API e serviços
- Solicite sua chave de API
Entre na sua conta Onlinecomponents.com e vá para o seu perfil de cliente
No perfil do cliente, localize a seção denominada "Acesso e serviços de API". Você também pode clicar diretamente aqui para acessar a página Acesso e serviços de API
Adicionar nova filial
Localizado: Sandbox Environment
Entendemos a importância dos testes antes de entrar em produção. Por isso fornecemos um ambiente sandbox totalmente funcional onde você pode experimentar todas as nossas APIs sem afetar seus dados de produção.
Acessando o Sandbox
- Solicitando uma chave API Sandbox
- URL base diferente
- https://api.onlinecomponents.com
- https://sandbox.onlinecomponents.com
- Portal do desenvolvedor Sandbox
Solicite sua Sandbox API Key na página API Access and Services. Essa chave é distinta da sua chave de produção e é usada exclusivamente para testes de sandbox.
Embora os endpoints da API permaneçam os mesmos, o ambiente sandbox usa um URL base diferente.
Acesse o ambiente sandbox através do Sandbox Developer Portal. Aqui, você encontrará toda a documentação, ferramentas e suporte necessários para ajudar você a testar sua integração de forma eficaz
API de pesquisa
A API de pesquisa do Onlinecomponents.com é uma maneira poderosa, mas fácil, de obter acesso e utilizar dados, disponibilidade e preços de produtos do Onlinecomponents.com em seus próprios aplicativos
Descrição
O serviço Search API permite que os clientes utilizem dados de produtos, disponibilidade e preços do Onlinecomponents.com em seus próprios aplicativos. Pesquise mais de 8 milhões de produtos e informações detalhadas sobre produtos com facilidade. O JSON Data Format agora está disponível para o Onlinecomponents.com Search API
-
Temos uma nova versão da API de pesquisa que é mais rápida e flexível:
- JSON oferece processamento mais rápido com dados de resposta mais limpos
- A formatação dos dados é mais limpa e mais fácil de exibir em navegadores modernos
- Controle de versão da API: solicitações e respostas estão disponíveis em JSON ou XML
Características
- Slogan
- Método de pesquisa por palavra-chave
- Método de pesquisa por Part Number
- Até 50 resultados retornados por chamada
- Até 100 chamadas por minuto
- Telefone do cliente#
Dados disponíveis
- 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
Endpoints
API de pedidos
Obtenha acesso ao processo de checkout da Onlinecomponents.com e encomende peças dentro de seus próprios aplicativos.
Descrição
The Order API can be used to place and check pedidos 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 oferece processamento mais rápido com dados de resposta mais limpos
- A formatação dos dados é mais limpa e mais fácil de exibir em navegadores modernos
- Controle de versão da API: solicitações e respostas estão disponíveis em JSON ou XML
Endpoints
A Order API pode ser usada para fazer e verificar pedidos da Onlinecomponents.com. Ela deve ser usada em conjunto com a Pricing and Availability API.
Parâmetros do pedido
| Parâmetro | Descrição | Obrigatório |
|---|---|---|
| sim | ||
| firstName | Nome | sim |
| lastName | Sobrenome | sim |
| phoneNumber | número de telefone | sim |
| shippingMethod | sim | |
| accountNo | Número da conta de envio | sim |
| carrier | Não | |
| shippingInsurance | sim | |
| taxable | sim | |
| resaleNumber | Não | |
| shippingAddress | Endereço de entrega | sim |
| shippingAddress.firstName | Nome | sim |
| shippingAddress.lastName | Sobrenome | sim |
| shippingAddress.company | companhia | sim |
| shippingAddress.countryTwoletterISOCode | país | sim |
| shippingAddress.stateProvinceAbbreviation | estado | sim |
| shippingAddress.city | cidade | sim |
| shippingAddress.address1 | Endereço 1 | sim |
| shippingAddress.address2 | Endereço 2 | sim |
| shippingAddress.zipPostalCode | CEP / Código Postal | sim |
| shippingAddress.phoneNumber | número de telefone | sim |
| billingAddress | 4. Digite um nome para seu aplicativo e clique | sim |
| billingAddress.firstName | Nome | sim |
| billingAddress.lastName | Sobrenome | sim |
| billingAddress.company | companhia | sim |
| billingAddress.countryTwoletterISOCode | país | sim |
| billingAddress.stateProvinceAbbreviation | estado | sim |
| billingAddress.city | cidade | sim |
| billingAddress.address1 | Endereço 1 | sim |
| billingAddress.address2 | Endereço 2 | sim |
| billingAddress.zipPostalCode | CEP / Código Postal | sim |
| billingAddress.phoneNumber | número de telefone | sim |
| paymentMethod | Método de pagamento | sim |
|
CustomerPoNumber
|
no | |
| orderComment | Comentário da encomenda | Não |
| orderItem | sim | |
| orderItem.productId | Identificador da linha da encomenda | sim |
| orderItem.partNumber | Não | |
| orderItem.manufacturerName | Não | |
| orderItem.quantity | Qtd. | sim |
| orderItem.price | preço | Não |
| orderItem.customerpartnumber | Número de peça do cliente | Não |
| currencycode | Código da moeda | Não |
Exemplo de pedido
{
"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",
}
Exemplo de resposta
{
"orderId": "string",
"errors": [
"string"
],
"success": true
}
Métodos de envio disponíveis
Opções nacionais
| Código da transportadora | Código do serviço |
|---|---|
| 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 |
Opções internacionais
| Código da transportadora | Código do serviço |
|---|---|
| UPS | UPS World Wide Express |
| UPS | UPS World Wide Saver |
| UPS | UPS World Wide Expedited |
| FEDEX | FedEx International Priority |
| FEDEX | FedEx International Economy |
Métodos de pagamento disponíveis
| Nome do método de pagamento |
|---|
| Net30 |
| Net45 |
| Net60 |
| PrePayment |
| Net15 |
| Net75 |
| Net90 |
Moedas disponíveis
| Moeda | Código da moeda |
|---|---|
| USD | usd |
| EUR | eur |
Possíveis mensagens de erro
Segue-se uma lista das mensagens de erro que podem ser devolvidas devido a um erro no pedido da API ou a um pré-requisito interno não satisfeito.
| Descrição |
|---|
| 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 de histórico de pedidos
Obtenha acesso ao processo de checkout da Onlinecomponents.com e encomende peças dentro de seus próprios aplicativos.
Descrição
The Order API can be used to place and check pedidos 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 oferece processamento mais rápido com dados de resposta mais limpos
- A formatação dos dados é mais limpa e mais fácil de exibir em navegadores modernos
- Controle de versão da API: solicitações e respostas estão disponíveis em JSON ou XML
Endpoints
A Order API pode ser usada para fazer e verificar pedidos da Onlinecomponents.com. Ela deve ser usada em conjunto com a Pricing and Availability API.