庫存和定價 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 存取權。請參閱速率限制,了解詳細資訊。

庫存和定價流程

  1. 驗證:使用指派給您的 API 金鑰和密鑰取得存取權杖。 
  2. 傳送請求:在您的要求中附上所需的 OPN。您可以使用同一個有效存取權杖提出多個要求。
  3. 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"
}