库存和价格 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"表示供货周,而不是实际供货日期。日期和数量都仅为预测值,而不能被视为承诺。
- 订单限制:“Limit”字段显示此商品每个订单允许的最大数量(如果没有限制,则为空白)。
- 附加选项:请参阅 API 规范以了解更多查询参数,从而优化搜索。
重要说明:
- 不是所有器件都能提供未来库存信息。
- 库存将按照先到先得的方式分配,且不可预订。
- 考虑设置库存订阅,以便在其他库存到货时获得实时通知。
示例
以下说明如何检索每个产品的库存情况和价格信息的示例将查询器件型号 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.cn/product/cn/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"
}