ASIN 스냅샷 쿼리 대기열에 ASIN/ISBN 추가
ASIN/ISBN을 Asin 스냅샷 쿼리 대기열에 추가하라는 요청입니다.
신용공제
데이터 검색 성공 후 1회 크레딧 공제.
요청
| URI | /api/query/add/{ASIN/ISBN}?domain={도메인}&secretKey={secretKey}&condition={조건} | {ASIN/ISBN} – 필수 – 추적 목록에 추가할 ASIN 또는 ISBN {domain} – 선택 사항 – 지정하지 않은 경우 기본값은 www.amazon.com입니다. 보다 지원되는 Amazon 도메인 목록을 위해.
{상태} – 선택 사항 – null/지정되지 않은 경우 기본값은 new입니다. 유효한 값 [신품, 중고, 수집품, 리퍼브 상품, 모두] {제외moq} – 선택 사항 – null/지정되지 않은 경우 기본값은 false입니다. 유효한 값[true, false]. true인 경우 Amzpecty는 moq 조회를 제외합니다. |
| HTTP 헤더(선택사항) | AMZPECTY_CALLBACK_URL={콜백 URL} | |
| 예시 | /api/query/add/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx &condition=used&excludemoq=false | |
응답
| 헤더 | |
| 미디어 종류 | 응용 프로그램 / json |
| JSON 데이터 |
JSON
{
"status": "OK",
"allowed": 4971,
"messageId": null,
"message": null,
"data": null,
"rid": "58eb4fb8bfc2333894ce7dc7",
"dateProcessed": null
}주의 사항: 콜백 중에 Rid를 사용하여 콜백 데이터를 원래 요청 호출에 연결할 수 있습니다.
ASIN 스냅샷 쿼리 콜백
ASIN 스냅샷 쿼리 콜백 요청
| URI | 예: https://your.server.com/amzpecty_result | {환경설정 페이지에 URL을 제공하세요.} URL은 SSL을 활성화해야 합니다. AMZPECTY-API-SECRET-KEY(헤더 이름) – 콜백 서버가 요청 원본을 검증하기 위해 비밀 키 헤더가 포함됩니다. |
| 미디어 종류 | 응용 프로그램 / json | |
ASIN 스냅샷 쿼리 콜백 JSON 샘플 데이터
| 헤더 | |
| 미디어 종류 | 응용 프로그램 / json |
| JSON 데이터 |
JSON
{
"status": "OK",
"responsefor": "asinsnapshot",
"allowed": 4992,
"dailyAllowed": 500,
"messageId": null,
"message": null,
"data": {
"queryAsin": "B01MYEYYYY",
"asin": "B01MYEYYEE",
"itemName": "Nest 9750016 T3016US Thermostat Black",
"brand": "by Nest",
"salesRank": 11346,
"totalQty": 150,
"buyboxPrice": "237.15",
"buyboxSellerName": "JJJ SELLER",
"buyboxSellerId": "AAW8R82WBLFL9",
"buyboxItemCondition": "New",
"totalFBA": 6,
"totalFBM": 7,
"maxPrice": 599,
"minPrice": 237.79,
"avgPrice": 293.05,
"isAmazonSelling": false,
"isAmazonWarehouseSelling": false,
"customerStarRating": "4.5 out of 5 stars",
"customerReview": "5,006 ratings",
"totalOffers": 1,
"pageNotFound": false,
"hasVariations": true,
"unavailable": false,
"offers": [
{
"sellerName": "cables4computer",
"condition": "New",
"price": 237.79,
"priceShipping": 0,
"priceTotal": 237.79,
"fba": false,
"inventoryCount": 11,
"conditionNote": "",
"ratingStar": 4.5,
"sellerRating": "89% positive over the past 12 months. (13,223 total ratings)",
"prime": false,
"sellerId": "A3VZC5G7U3OWU4",
"offerId": "8pwpOXydEI1znRNLYpU",
"moq": false,
"moqvalue": 0
}
]
},
"rid": "5d6e0b63e4b0e29d7d7d232c",
"dateProcessed": 1567492992552,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}ASIN 스냅샷 쿼리 콜백 응답 JSON 속성
| 속성 이름 | 세부 정보 |
|---|---|
| 지위 | 요청 상태입니다. |
| 응답 | 판매자 정보 쿼리 결과의 "sellerinfo" 값입니다. |
| 수 | 현재 허용되는 요청 수입니다. 매월 재설정됩니다. |
| 매일 허용됨 | 현재 허용되는 일일 요청 수입니다. 매일 재설정됩니다. |
| 메시지 ID | 메시지의 ID입니다(있는 경우). |
| 메시지 | 실제 메시지(있는 경우) 오류 메시지를 참조하세요. |
| 제거 | 요청 ID입니다. 이는 Get 쿼리에서 키로 사용될 수 있습니다. |
| 도메인 | 판매자에 해당하는 Amazon 도메인입니다. |
| 총 공제된 크레딧 | 이 필드는 이 요청을 이행하는 데 사용된 Amzpecty API 크레딧 수를 나타냅니다. |
| 처리된 날짜 | 요청이 처리된 날짜는 유닉스 시간 형식입니다. |
| data.queryAsin | ADD 호출에 지정된 ASIN입니다. |
| 데이터.아신 | 상품의 ASIN입니다. ASIN은 ADD 호출에 지정된 ASIN과 다를 수 있습니다. 예: 병합된 ASIN 또는 삭제된 ASIN의 경우. |
| 데이터. 상품명 | 제품의 품목 이름입니다. |
| 데이터. 상표 | 제품의 브랜드 이름입니다. |
| 데이터. 판매 순위 | 이 제품의 모든 제안의 최고 가격입니다. |
| 데이터. 총 수량 | 제품의 예상 총 수량입니다. |
| 데이터. 바이박스가격 | 배송비를 제외한 제품의 현재 바이박스 가격입니다. |
| 데이터. buybox판매자 이름 | 제품의 현재 바이박스 판매자 이름입니다. |
| 데이터. buybox판매자 ID | 바이박스 판매자의 판매자 ID입니다. |
| 데이터. buyboxItemCondition | 바이박스(Buy Box) 품목의 상태입니다. |
| 데이터. 총 FBA | FBA 셀러의 총 수입니다. |
| 데이터. 총FBM | FBM 판매자의 총 수입니다. |
| 데이터. 최대 가격 | 이 제품의 모든 제안의 최고 가격입니다. |
| 데이터. 최소 가격 | 이 제품의 모든 제안에 대한 최소 가격입니다. |
| 데이터. 평균가격 | 이 제품의 모든 제안의 평균 가격입니다. |
| 데이터. isAmazon판매 | Amazon에 이 아이템에 대한 제안이 있는 경우 편의 플래그입니다. |
| 데이터. isAmazon창고판매 | Amazon Warehouse에 이 아이템에 대한 제안이 있는 경우 편의 플래그입니다. |
| 데이터. 고객별점수 | 고객 별점. 샘플 값 '별 4.5개 중 5개' |
| 데이터. 고객리뷰 | 고객 리뷰 수입니다. 샘플 값 “평가 5,006개” |
| 데이터. 총 제안 | 이 제품의 총 제안 수입니다. |
| 데이터.사용할 수 없음 | true인 경우 이 플래그는 나열된 제품에 대한 제안이 없음을 나타냅니다. |
| data.hasVariations | true인 경우 이 플래그는 이 제품의 다른 변형이 있음을 나타냅니다. |
| data.pageNotFound | true인 경우 이 플래그는 ASIN이 현재 목록에 없음을 나타냅니다. |
| data.imageUrl | 제품 이미지의 URL입니다. |
| 데이터. 제안[] | 제품의 제안 목록입니다. |
| 제안[n]. 판매자이름 | 제품을 제공하는 판매자의 판매자 이름입니다. |
| 제안[n]. 판매자ID | 이 제안 판매자의 판매자 ID입니다. |
| 제안[n]. 상태 | 제품의 상태입니다. |
| 제안[n]. 가격 | 제품의 가격입니다. |
| 제안[n]. 가격배송 | 이 제품이 제공하는 배송비입니다. |
| 제안[n]. 가격총액 | 이 제품 제안의 가격과 배송비의 합계입니다. |
| 제안[n]. FBA | 제안 FBA 플래그입니다. |
| 제안[n]. 재고 개수 | 이 제품의 판매자가 제공하는 사용 가능한 수량입니다. |
| 제안[n]. 상태참고 | 제품 상태에 대한 참고사항입니다. (만약에 어떠한) |
| 제안[n]. 평가별 | 제품을 제공하는 판매자의 별점입니다. |
| 제안[n]. 판매자 평가 | 제품을 제공하는 판매자의 평점입니다. |
| 제안[n]. 초기 | 이 제안이 우대 대상인지 여부를 나타내는 플래그입니다. |
| 제안[n]. 판매자ID | 이 제안 판매자의 판매자 ID입니다. |
| 제안[n]. 제안 ID | 이 제안의 ID |
| 제안[n]. moq | 이 제안의 최소 주문 수량 플래그입니다. (판매자가 MOQ를 부과하는 경우) |
| 제안[n]. moq값 | 이 제안의 실제 최소 주문 수량 값입니다. (판매자가 MOQ를 부과하는 경우) |
ASIN/ISBN별 ASIN 스냅샷 결과 받기
ASIN/ISBN별 최신 Asin 스냅샷 결과를 가져오기 위한 요청입니다.
신용공제
Get 호출에 대한 0(영) 크레딧 공제.
요청
| URI | /api/query/get/asin/{ASIN/ISBN}?domain={도메인}&secretKey={secretKey} | {ASIN/ISBN} – 최신 추적 목록을 가져올 ASIN {domain} – 선택 사항 – 지정하지 않은 경우 기본값은 www.amazon.com입니다. 보다 지원되는 Amazon 도메인 목록을 위해. |
| 예시 | /api/query/get/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
응답
요청 ID로 ASIN 스냅샷 결과 받기
요청 ID(rid)를 기준으로 최신 Asin 스냅샷 결과를 가져오기 위한 요청입니다.
신용공제
Get 호출에 대한 0(영) 크레딧 공제.
요청
| URI | {rid} – /api/query/add/ 응답의 요청 ID {domain} – 선택 사항 – 지정하지 않은 경우 기본값은 www.amazon.com입니다. 보다 지원되는 Amazon 도메인 목록을 위해. | |
| 예시 | /api/query/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx | |
응답
요청 ID로 ASIN 스냅샷 결과 받기
요청 ID(rid)를 기준으로 최신 Asin 스냅샷 결과를 가져오기 위한 요청입니다.
신용공제
Get 호출에 대한 0(영) 크레딧 공제.
요청
| URI | {rid} – /api/query/add/ 응답의 요청 ID {domain} – 선택 사항 – 지정하지 않은 경우 기본값은 www.amazon.com입니다. 보다 지원되는 Amazon 도메인 목록을 위해. | |
| 예시 | /api/query/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx | |
