Guida introduttiva
Benvenuti alla suite API di Onlinecomponents.com! Seguite questi passaggi per iniziare:
Autenticazione
Per accedere alle API di Onlinecomponents.com, avrai bisogno di una chiave API. Puoi ottenere sia le chiavi API di produzione che quelle sandbox dalla stessa posizione:
- Navigate to your cliente profile
- Vai ad Accesso API e servizi
- Richiedi la tua chiave API
Accedi al tuo account Onlinecomponents.com e vai al tuo profilo cliente
Nel profilo del cliente, individua la sezione denominata "Accesso API e servizi". Puoi anche cliccare direttamente qui per accedere alla pagina Accesso API e servizi
Aggiungi nuova filiale
Localizzato: Sandbox Environment
Comprendiamo l'importanza dei test prima della pubblicazione. Per questo forniamo un ambiente sandbox completamente funzionale in cui puoi sperimentare tutte le nostre API senza influire sui dati di produzione.
Accesso al Sandbox
- Richiesta di una chiave API Sandbox
- URL di base diverso
- https://api.onlinecomponents.com
- https://sandbox.onlinecomponents.com
- Portale sviluppatori sandbox
Richiedi la tua chiave API Sandbox dalla pagina API Access and Services. Questa chiave è distinta dalla tua chiave di produzione e viene utilizzata esclusivamente per i test sandbox.
Sebbene gli endpoint API rimangano gli stessi, l'ambiente sandbox utilizza un URL di base diverso.
Accedi all'ambiente sandbox tramite il Sandbox Developer Portal. Qui troverai tutta la documentazione, gli strumenti e il supporto necessari per aiutarti a testare efficacemente la tua integrazione
API di ricerca
L'API di ricerca di Onlinecomponents.com è un modo potente ma semplice per accedere e utilizzare i dati sui prodotti, la disponibilità e i prezzi di Onlinecomponents.com nelle tue applicazioni
Descrizione
Il servizio Search API consente ai clienti di utilizzare i dati sui prodotti, la disponibilità e i prezzi di Onlinecomponents.com nelle proprie applicazioni. Cerca oltre 8 milioni di prodotti e informazioni dettagliate sui prodotti con facilità. Il formato dati JSON è ora disponibile per Onlinecomponents.com Search API
-
Abbiamo una nuova versione della Search API, più veloce e flessibile:
- JSON offre un'elaborazione più rapida con dati di risposta più puliti
- La formattazione dei dati è più pulita e più facile da visualizzare nei browser moderni
- Controllo versione API: richieste e risposte sono disponibili in JSON o XML
Caratteristiche
- Slogan
- Metodo di ricerca per parola chiave
- Metodo di ricerca per Part Number
- Fino a 50 risultati restituiti per chiamata
- Fino a 100 chiamate al minuto
- Telefono cliente#
Dati disponibili
- 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
Endpoint
API Ordini
Ottieni accesso al processo di checkout di Onlinecomponents.com e ordina componenti all'interno delle tue applicazioni.
Descrizione
The Order API can be used to place and check ordines 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 offre un'elaborazione più rapida con dati di risposta più puliti
- La formattazione dei dati è più pulita e più facile da visualizzare nei browser moderni
- Controllo versione API: richieste e risposte sono disponibili in JSON o XML
Endpoint
L'Order API può essere utilizzata per effettuare e controllare ordini da Onlinecomponents.com. È destinata a essere usata insieme alla Pricing and Availability API.
Parametri della richiesta
| Parametro | Descrizione | Obbligatorio |
|---|---|---|
| sì | ||
| firstName | Nome | sì |
| lastName | Cognome | sì |
| phoneNumber | Numero di telefono | sì |
| shippingMethod | sì | |
| accountNo | Numero di conto di spedizione | sì |
| carrier | No | |
| shippingInsurance | sì | |
| taxable | sì | |
| resaleNumber | No | |
| shippingAddress | Indirizzo di spedizione | sì |
| shippingAddress.firstName | Nome | sì |
| shippingAddress.lastName | Cognome | sì |
| shippingAddress.company | azienda | sì |
| shippingAddress.countryTwoletterISOCode | nazione | sì |
| shippingAddress.stateProvinceAbbreviation | stato | sì |
| shippingAddress.city | città | sì |
| shippingAddress.address1 | Indirizzo 1 | sì |
| shippingAddress.address2 | Indirizzo 2 | sì |
| shippingAddress.zipPostalCode | CAP / codice postale | sì |
| shippingAddress.phoneNumber | Numero di telefono | sì |
| billingAddress | 4. Digita un nome per la tua app e fai clic | sì |
| billingAddress.firstName | Nome | sì |
| billingAddress.lastName | Cognome | sì |
| billingAddress.company | azienda | sì |
| billingAddress.countryTwoletterISOCode | nazione | sì |
| billingAddress.stateProvinceAbbreviation | stato | sì |
| billingAddress.city | città | sì |
| billingAddress.address1 | Indirizzo 1 | sì |
| billingAddress.address2 | Indirizzo 2 | sì |
| billingAddress.zipPostalCode | CAP / codice postale | sì |
| billingAddress.phoneNumber | Numero di telefono | sì |
| paymentMethod | Metodo di pagamento | sì |
|
CustomerPoNumber
|
no | |
| orderComment | Commento dell'ordine | No |
| orderItem | sì | |
| orderItem.productId | Identificatore della riga dell'ordine | sì |
| orderItem.partNumber | No | |
| orderItem.manufacturerName | No | |
| orderItem.quantity | Qtà | sì |
| orderItem.price | prezzo | No |
| orderItem.customerpartnumber | Numero parte cliente | No |
| currencycode | Codice valuta | No |
Esempio di richiesta
{
"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",
}
Esempio di risposta
{
"orderId": "string",
"errors": [
"string"
],
"success": true
}
Metodi di spedizione disponibili
Opzioni nazionali
| Codice vettore | Codice servizio |
|---|---|
| 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 |
Opzioni internazionali
| Codice vettore | Codice servizio |
|---|---|
| UPS | UPS World Wide Express |
| UPS | UPS World Wide Saver |
| UPS | UPS World Wide Expedited |
| FEDEX | FedEx International Priority |
| FEDEX | FedEx International Economy |
Metodi di pagamento disponibili
| Nome del metodo di pagamento |
|---|
| Net30 |
| Net45 |
| Net60 |
| PrePayment |
| Net15 |
| Net75 |
| Net90 |
Valute disponibili
| Valuta | Codice valuta |
|---|---|
| USD | usd |
| EUR | eur |
Possibili messaggi di errore
Di seguito sono elencati i messaggi di errore che possono essere restituiti a causa di un errore nella richiesta API o di un prerequisito interno non soddisfatto.
| Descrizione |
|---|
| 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 Cronologia ordini
Ottieni accesso al processo di checkout di Onlinecomponents.com e ordina componenti all'interno delle tue applicazioni.
Descrizione
The Order API can be used to place and check ordines 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 offre un'elaborazione più rapida con dati di risposta più puliti
- La formattazione dei dati è più pulita e più facile da visualizzare nei browser moderni
- Controllo versione API: richieste e risposte sono disponibili in JSON o XML
Endpoint
L'Order API può essere utilizzata per effettuare e controllare ordini da Onlinecomponents.com. È destinata a essere usata insieme alla Pricing and Availability API.