재고 및 가격 API
생산 엔드포인트:
https://transact.ti.com/v2/store/products/
https://transact.ti.com/v2/store/products/catalog
재고 및 가격 API는 OPN(주문 가능 부품 번호) 및 GPN(일반 부품 번호)에 대한 실시간 재고 가용성과 가격을 제공합니다. 또한 이 정보를 사용하여 사용 가능한 모든 TI 부품 번호의 전체 카탈로그를 가져올 수도 있습니다.
주문하기 전에 개별 품목의 가용성을 확인하십시오. 푸시 대 검색 구현:
- 검색: 필요할 때마다 API를 호출하여 최신 데이터를 가져옵니다.
- 푸시(웹 후크): 특정 부품을 사용할 수 있게 되면 실시간 알림을 받습니다. 이 기능을 사용하여 자동화된 워크플로우를 트리거합니다(자세한 내용은 푸시 알림 참조).
중요 속도 제한: 카탈로그 API는 4시간마다 요청 1개(하루 요청 6개)로 제한됩니다. 이 한도를 초과하면 API 액세스가 제한되거나 취소될 수 있습니다. 추가적인 제한은 속도 제한을 참조하십시오.
재고 및 가격 흐름
- 인증: 할당된 API 키와 암호를 사용하여 액세스 토큰을 받습니다.
- 요청 보내기: 요청에 원하는 OPN을 포함합니다. 동일한 유효한 액세스 토큰으로 여러 요청을 수행할 수 있습니다.
- API 응답: 상태 코드(200 OK)와 제품 데이터를 포함하는 JSON 문자열을 받게 됩니다.
- 가용성: '수량' 필드에는 현재 재고가 있는 항목의 수가 표시됩니다.
- 가격: JSON 응답에 포함됩니다(특정 형식은 API에 따라 다름).
- 향후 가용성:
- '향후 재고'는 향후 재고에 대한 예상 날짜 및 수량을 반환합니다.
- 알 수 없는 경우 'ForecastQuantity'가 null일 수 있습니다.
- "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"
}