庫存和定價 API
生產端點:
https://transact.ti.com/v2/store/products/
https://transact.ti.com/v2/store/products/catalog
庫存和定價 API 提供可訂購零件編號 (OPN) 和通用零件編號 (GPN) 的即時可用庫存和定價。您也可用來提取所有可用 TI 零件編號的完整目錄。
下單前,請先檢查個別品項的供貨狀況。推播與擷取實作:
- 擷取:必要時可呼叫 API 以取得最新資料。
- 推播 (Webhook):當特定零件有貨時,會收到即時通知。使用此選項可觸發自動化工作流程(更多資訊請參閱推播通知)。
重要速率限制:目錄 API 限制每 4 小時 1 次要求(每天 6 次要求)。若超過此限制,將會限制或撤銷您的 API 存取權。請參閱速率限制,了解詳細資訊。
庫存和定價流程
- 驗證:使用指派給您的 API 金鑰和密鑰取得存取權杖。
- 傳送請求:在您的要求中附上所需的 OPN。您可以使用同一個有效存取權杖提出多個要求。
- API 回應:您會收到一個狀態程式碼 (200 OK) 和一個包含產品資料的 JSON 字串:
- 供貨狀況:「數量」欄位顯示目前庫存中的品項數量。
- 定價:包含在 JSON 回應中(具體格式視 API 而定)。
- 未來供貨狀況:
- 「未來庫存」會傳回未來庫存的預估日期和數量。
- 如果未知「forecastQuantity」可能為無。
- "forecastDate"表示可供貨的週,而不是可供貨的實際日期。日期和數量都只是預測值,不應視為承諾。
- 訂單限制:「限制」欄位顯示此品項每筆訂單允許的最大數量(若無限制則為空白)。
- 其他選項:如需更多查詢參數以調整搜尋範圍,請參閱 API 規格。
重要注意事項:
- 並非所有零件皆可使用未來庫存資訊。
- 庫存將根據先到先得的方式配置,不能預留。
- 考慮設定庫存訂閱,以便在可供應額外庫存時獲得即時通知。
範例
以下說明如何擷取每個產品的庫存可供應情況和定價資訊的範例,正在查詢零件編號 AFE7799IABJ。
- 可供應庫存為 5,435("數量:"5435)。
- 但在此範例中,數量限制為每筆訂單 50("限制值:"50) 個。
- 如果產品沒有訂購限制、JSON 回應會在限制值欄位傳回空白值。
- 如需了解其他查詢參數,請參閱下方規格。
請求範例:
curl --request GET \
--url 'https://transact.ti.com/v2/store/products/AFE7799IABJ?currency=USD' \
--header 'Authorization: Bearer {access_token}' \
回應成功請求:
{
"tiPartNumber": "AFE7799IABJ",
"genericPartNumber": "AFE7799",
"buyNowURL": "https://www.ti.com/product/AFE7799/part-details/AFE7799IABJ",
"quantity": 5435,
"limit": 50,
"pricing": [
{
"currency": "USD",
"priceBreaks": [
{
"priceBreakQuantity": 1,
"price": 2.03
},
{
"priceBreakQuantity": 10,
"price": 1.43
},
{
"priceBreakQuantity": 25,
"price": 1.35
},
"futureInventory": [
{
"forecastQuantity": 500,
"forecastDate": "2023-06-25"
},
{
"forecastQuantity": null,
"forecastDate": "2023-07-02"
} ],
"description": "8-Bit 200MSPS Low-Power Analog-to-Digital Converter (ADC) With Internal Sample and Hold",
"minimumOrderQuantity": 1,
"standardPackQuantity": 126,
"exportControlClassificationNumber": "EAR99",
"htsCode": "8542390001",
"pinCount": 5,
"packageType": "SOT-23 (DBV)",
"packageCarrier": "Large T&R",
"customReel": true,
"lifeCycle": "ACTIVE"
}