제품 변형 쿼리 대기열에 상위 ASIN 추가
제품 변형 쿼리 대기열에 상위 ASIN을 추가하라는 요청입니다.
신용공제
데이터를 성공적으로 검색한 후 각 변형에 대해 1회의 크레딧 공제. 예: 5개의 변형이 있는 경우 5개의 변형 정보가 모두 성공적으로 검색되면 5(XNUMX) 크레딧이 차감됩니다.
요청
URI | /api/query/requestvariants/ {PARENTASIN}?domain={도메인}&secretKey={secretKey} | {PARENTASIN } – 필수 – 변형 검색 대기열에 추가할 상위 ASIN입니다. {domain} – 선택 사항 – 지정하지 않은 경우 기본값은 www.amazon.com입니다. 보다 지원되는 Amazon 도메인 목록을 위해. |
HTTP 헤더(선택사항) | AMZPECTY_CALLBACK_URL={콜백 URL} | |
예 | /api/query/requestvariants/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx |
응답
헤더 | |
미디어 종류 | 응용 프로그램 / json |
JSON 데이터 |
JSON
{
"status": "OK",
"allowed": 999,
"dailyAllowed": 100,
"messageId": null,
"message": null,
"data": null,
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": null
}
제품 변형 쿼리 콜백
제품 변형 문의 콜백 요청
URI | 예: https://your.server.com/amzpecty_result | {환경설정 페이지에 URL을 제공하세요.} URL은 SSL을 활성화해야 합니다. AMZPECTY-API-SECRET-KEY(헤더 이름) – 콜백 서버가 요청 원본을 검증하기 위해 비밀 키 헤더가 포함됩니다. |
미디어 종류 | 응용 프로그램 / json |
제품 변형 쿼리 콜백 JSON 샘플 데이터
헤더 | |
미디어 종류 | 응용 프로그램 / json |
JSON 데이터 |
JSON
{
"status": "OK",
"responsefor": "productvariations",
"allowed": 142658,
"dailyAllowed": 9828,
"messageId": null,
"message": null,
"data": {
"parentAsin": "B077HN95T8",
"itemName": "Pendleton Women’s Heritage Chelsea Slip-Resistant Rain Boot",
"salesRank": 31070,
"options": [
"Size",
"Color"
],
"totalVariations": 86,
"variants": [
{
"asin": "B0772WW76G",
"productUrl": "https://www.amazon.com/dp/B0772WW76G?th=1&psc=1",
"option1": "Size",
"option1Value": "6",
"option2": "Color",
"option2Value": "Rainier Red",
"BBSellerName": "Fishbone Apparel",
"BBPrice": 109.95,
"BBQuantity": 2,
"BBType": "FBA",
"salesRank": 31070,
"totalOffers": 1,
"dimension": "3.8 x 9.5 x 11.7 inches",
"imageUrl": "https://m.media-amazon.com/images/I/31wd4kuv6IL._SCLZZZZZZZ__SL80_.jpg",
"weight": "3.351 pounds",
"reviewPercentage": 2.08,
"reviewCount": 2,
"globalRatingsPositive": 4486,
"globalRatingsCritical": 421,
"globalReviewPositive": 1286,
"globalReviewCritical": 271,
"recentReview": "March 7, 2020",
"searchStatus": "completed"
},
{
"asin": "B07PJT8S6K",
"productUrl": "https://www.amazon.com/dp/B07PJT8S6K?th=1&psc=1",
"option1": "Size",
"option1Value": "6",
"option2": "Color",
"option2Value": "Starwatchers Blue Print",
"BBSellerName": "new pairs",
"BBPrice": 109.95,
"BBQuantity": 2,
"BBType": "FBA",
"salesRank": 31070,
"totalOffers": 1,
"dimension": "4.25 x 10.87 x 13.07 inches",
"imageUrl": "https://m.media-amazon.com/images/I/41ooAxDOy5L._SCLZZZZZZZ__SL80_.jpg",
"weight": "3.4502 pounds",
"reviewPercentage": 0,
"reviewCount": 0,
"globalRatingsPositive": 0,
"globalRatingsCritical": 0,
"globalReviewPositive": 0,
"globalReviewCritical": 0,
"recentReview": "",
"searchStatus": "completed"
}
]
},
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": 1584429103564,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}
제품 변형 쿼리 콜백 응답 JSON 속성
속성 이름 | 세부 정보 |
---|---|
지위 | 요청 상태입니다. |
응답 | 제품 변형 쿼리 결과의 "productvariations" 값 |
수 | 현재 허용되는 요청 수입니다. 매월 재설정됩니다. |
매일 허용됨 | 현재 허용되는 일일 요청 수입니다. 매일 재설정됩니다. |
메시지 ID | 메시지의 ID입니다(있는 경우). |
메시지 | 실제 메시지(있는 경우) 참고해주세요 오류 메시지. |
제거 | 요청 ID입니다. 이는 이 응답을 원래 요청과 일치시키는 데 사용될 수 있습니다. |
처리된 날짜 | 요청이 처리된 날짜(Unix 시간 형식)입니다. |
도메인 | 대상 Amazon 도메인. |
총 공제된 크레딧 | 이 필드는 이 요청을 이행하는 데 사용된 Amzpecty API 크레딧 수를 나타냅니다. |
data.parentAsin | 이형 상품의 상위 ASIN입니다. |
데이터. 상품명 | 제품의 품목 이름입니다. |
데이터. 판매 순위 | 상위 제품의 판매 순위입니다. |
데이터. 옵션[] | 사용 가능한 옵션 목록입니다. 예: [ “크기”, “색상” ] |
data.totalVariations | 상위 Asin의 총 변형 수입니다. |
데이터. 변형[] | 상위 Asin의 변형 목록입니다. |
데이터.변형[n].asin | 이 변형의 Asin입니다. |
data.variants[n].productUrl | 이 변형의 제품 URL입니다. |
데이터.변형[n].옵션1 | data.options[]에 나열된 첫 번째 옵션의 키입니다. 예: '크기' |
data.variants[n].option1값 | 이 첫 번째 옵션의 값입니다. 예: '9' |
데이터.변형[n].옵션2 | data.options[]에 나열된 두 번째 옵션의 키입니다. 예: '색상' |
data.variants[n].option2값 | 이 두 번째 옵션의 값입니다. 예: '옐로스톤 옐로우' |
데이터.변형[n].옵션* | data.options[]에 나열된 이 n번째 옵션의 키입니다. |
data.variants[n].option*값 | 이 n번째 옵션의 값입니다. |
data.variants[n].BBSellerName | 이 변형의 바이박스 판매자 이름입니다. |
데이터.변형[n].BBPrice | 배송비를 제외한 이 변형의 바이박스 가격입니다. |
data.variants[n].BBQuantity | 이 이형 상품의 바이박스 판매자가 사용할 수 있는 수량입니다. |
데이터.변형[n].BBType | 이 변형의 판매자 유형입니다. “FBA” 또는 “FBM” |
데이터.변형[n].salesRank | 이 변형의 판매 순위입니다. |
data.variants[n].totalOffers | 이 변형의 제안 수입니다. |
데이터.변형[n].차원 | 이 변형의 측정기준입니다. |
data.variants[n].imageUrl | 이 변형의 이미지 URL입니다. |
데이터.변형[n].가중치 | 이 변형의 가중치입니다. |
data.variants[n].reviewPercentage | 이 변형의 ( 리뷰 수 / 모든 리뷰 수) X 100 . |
11년 2020월 XNUMX일부터 사용이 중단되었습니다. 대신 globalReviewPositive 및 globalReviewCritical을 사용하세요. | |
data.variants[n].globalRatingsPositive | 새로운. 11년 2020월 XNUMX일에 추가됨. 이 변형의 총 글로벌 긍정적 평가 수입니다. |
data.variants[n].globalRatingsCritical | 새로운. 11년 2020월 XNUMX일에 추가됨. 이 변형의 전체 글로벌 중요 평가 수입니다. |
data.variants[n].globalReviewPositive | 새로운. 11년 2020월 XNUMX일에 추가됨. 이 변형의 총 글로벌 긍정적 리뷰 수입니다. |
data.variants[n].globalReviewCritical | 새로운. 11년 2020월 XNUMX일에 추가됨. 이 변형의 총 글로벌 비판적 검토 수입니다. |
data.variants[n].recentReview | 이 변형의 가장 최근 검토 날짜입니다. |
data.variants[n].searchStatus | 이 변형의 쿼리 상태입니다. '진행 중' 또는 '완료' |
상위 ASIN의 제품 변형 쿼리 결과 데이터 가져오기
Get 호출에 대한 0(영) 크레딧 공제.
상위 ASIN별로 제품 변형 쿼리 결과 데이터를 가져오기 위한 요청입니다.
요청
URI | /api/query/getmatchasins/rid/{rid}?domain={도메인}&secretKey={secretKey} | { PARENTASIN } – 최신 변형 목록을 가져오기 위한 상위 ASIN {domain} – 선택 사항 – 지정되지 않은 경우 기본값은 www.amazon.com입니다. 보다 지원되는 Amazon 도메인 목록을 위해. |
예 | /api/query/getvariants/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx |
응답
요청 ID별로 제품 변형 요청 결과 데이터 가져오기
요청 ID별로 제품 변형 쿼리 결과 데이터를 가져오기 위한 요청입니다.
신용공제
Get 호출에 대한 0(영) 크레딧 공제.
요청
URI | /api/query/getvariants/rid/{ RID }?domain={도메인}&secretKey={secretKey} | { RID } – 최신 변형 목록을 가져오기 위한 요청 ID입니다. {domain} – 선택 사항 – 지정하지 않은 경우 기본값은 www.amazon.com입니다. 보다 지원되는 Amazon 도메인 목록을 위해. |
예 | /api/query/getvariants/rid/ 5e712345e4b04dd8c8b7e490?domain=www.amazon.com&secretKey= xxxxxxxxxx |