庫存和定價 API
生產端點:
https://transact.ti.com/v2/store/products/
https://transact.ti.com/v2/store/products/catalog
庫存和定價 API 提供可訂購零件編號 (OPN) 和通用零件編號 (GPN) 的即時可用庫存和定價,並且可提取所有 TI 零件編號的完整目錄。在建立訂單之前,您必須驗證個別項目的供貨狀況。在推播或擷取實作中,可使用此 API。當可供應個別零件時,推播 API 會即時向您的系統傳送 Webhook,且可用於觸發自動化流程。如需詳細資訊,請參見推播通知。
附註:目錄 API 限制每四小時可提出一次要求,每天總共六次要求。若超過此限制,就會限制或撤銷您的 API 存取權。請參閱速率限制以了解其它限制。
庫存定價流程概覽
- 進行驗證,方法為使用指派給您的 API 金鑰和秘密。
- 收到存取權杖後,請傳送包含 OPN 的請求。只要權杖尚未過期,就可以在同一個工作階段中使用存取權杖進行多個要求。
- API 將會回覆狀態代碼 200 OK,以及包含產品資料的 JSON 字串。
- 亦提供其它查詢參數以用於調整搜尋,請參見下方規格。
在預期可供應更多庫存時,「未來庫存」會傳回預測日期和數量的陣列。如果數量未知,則「forecastQuantity」欄位會傳回空值。「forecastDate」欄位表示可供應的週,而不是可供應的實際日期。日期和數量都只是預測值,不應視為承諾。庫存將根據先到先得的方式供應,不能預留。建議您設定庫存訂閱,以便在可供應額外庫存時獲得通知。附註:並非所有零件都提供未來的庫存資訊。
以下說明如何擷取每個產品的庫存可供應情況和定價資訊的範例,正在查詢零件編號 AFE7799IABJ。可供應庫存為 5,435 ("quantity:" 5435);但在此範例中,數量限制為每筆訂單 50 ("limit:" 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 位元 200MSPS 低功耗類比轉數位轉換器 (ADC)","minimumOrderQuantity": 1, "standardPackQuantity": 126, "exportControlClassificationNumber": "EAR99","htsCode": "8542390001","pinCount": 5, "packageType": "SOT-23 (DBV)","packageCarrier": "Large T&R","customReel": true, "lifeCycle": "ACTIVE" }