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 | |
응답
만나다 Asin 스냅샷 쿼리 콜백 JSON 샘플 데이터
요청 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 | |
응답
만나다 Asin 스냅샷 쿼리 콜백 JSON 샘플 데이터
요청 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 | |
