在庫と価格設定 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 件の要求 (1 日あたり 6 件の要求) に制限されています。この制限を超過すると、貴社の API アクセスが制限または取り消される可能性があります。詳細はレート制限をご参照ください。

在庫と価格設定フロー

認証：貴社に割り当てられた API キーとシークレットを使用して、アクセストークンを取得します。
リクエストを送信：リクエストでご希望の OPN を含めます。同じ有効なアクセストークンを使用して、複数のリクエストを行うことができます。
API の応答：ステータスコード (200 OK) と、製品データを含める JSON 文字列が受信されます。
- 入手可能状況：「quantity」(数量) フィールドには、現在在庫があるアイテムの数が表示されます。
- 価格設定：JSON 応答の中に含まれます (特定の形式は、API によって異なります)。
- 今後の入手状況：
  - 「Future Inventory」(将来の在庫) は、今後の在庫入荷に関する予定日と数量を返します。
  - 「forecastQuantity」(予測数量) は、不明な場合はヌルになるがあります。
  - 「forecastDate」 (予測日) フィールドは、入手可能になる実際の日付ではなく、入手可能になる週を表します。日付と数量のどちらも予測にすぎず、確定値と考えることはできません。

注文制限：「limit」(制限) フィールドは、この品目で注文 1 件あたりの最大許容数量を示します (制限がない場合は空白)。
その他のオプション：検索を絞り込むための他のクエリパラメータについては、API の仕様をご参照ください。

重要な注意事項：

将来の在庫情報は、利用できない部品がある場合があります。
入手可能な在庫は、FIFO (先に到着したご注文を先に処理) ベースで配分され、事前に予約することはできません。
追加の在庫が入手可能になった際に、リアルタイム通知を行うための在庫サブスクリプション (自動参照) のセットアップを検討してください。

例

以下の例は、製品ごとの在庫状況と価格情報を取得する方法を示すために、型番 AFE7799IABJ の問い合わせを行います。

入手可能な在庫は 5,435 です ("quantity:"5435)。
ただし、この例では、数量は 50 に制限されています ("limit:"50)。これは注文ごとの単位数です。
製品に注文制限がない場合、JSON 応答は limit (制限) フィールドに空白の値を返します。
他のクエリパラメータについては、以下の仕様をご覧ください。

要求の例：

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"
}