AliExpress
AliExpress를 공통 마켓플레이스 스키마로 제공합니다. 모든 마켓플레이스와 같은 `SearchResult`와 `Product`에 더해 배송 견적을 돌려줍니다.
오퍼레이션
| 오퍼레이션 | 엔드포인트 | 반환 | 가격 |
|---|---|---|---|
| Search | GET | POST /v1/aliexpress/search | SearchResult | $0.001 |
| Image Search | POST /v1/aliexpress/image-search | SearchResult | $0.001 |
| Browse | GET | POST /v1/aliexpress/browse | SearchResult | $0.001 |
| Categories | GET | POST /v1/aliexpress/categories | CategoryList | $0.001 |
| Product | GET | POST /v1/aliexpress/product | Product | $0.001–$0.002 |
| Shipping | GET | POST /v1/aliexpress/shipping | ShippingQuote | $0.001–$0.002 |
AliExpress의 옛 엔드포인트(/aliexpress/keyword-search, /aliexpress/product-details, 버전 없는 /aliexpress/image-search)는 지원이 중단되었고 v1 URL이 없습니다. 각각의 대체 엔드포인트는 Versioning에 있습니다.
AliExpress에만 해당하는 것
변형을 따로 조회할 수 없습니다. 사이즈나 색상은 하나의 상품 안에 있는 SKU이므로
variant.productId가 없습니다. 한 번의 호출로 SKU별 가격과 stock(숫자)을 포함한 변형 전체를 받습니다.
변형의 id는 AliExpress의 숫자 SKU id이며, shipping이 받는 값이 바로 이것입니다.
상품 하나에 id 하나. AliExpress는 일부 상품을 두 가지로 표기합니다(키워드 검색에서는 3256…,
그 밖에서는 1005…). 모든 응답은 전역 1005… 형식을 쓰며, 입력으로는 둘 다 받습니다.
배송은 요청할 때만 받는 견적입니다. product?include=shipping은 delivery(region까지 가장 저렴한
옵션)와 shippingOptions(모든 옵션)를 더합니다. shipping은
어떤 변형·수량이든 따로 견적합니다. 이를 쓰지 않아도 delivery.handlingDays가 판매자의 발송 소요일을
알려 줍니다.
상품에는 AliExpress가 밝히는 모든 것이 담깁니다. 이름이 붙은 카테고리 경로, package 무게(크기는
포장의 ext), 스토어의 country(스토어 평점 세 가지는 판매자의 ext.detailedRatings), 변형별
purchaseLimit(bulkPrice·taxIncluded는 변형의 ext), 그리고 상품 ext의 wholesale. 가격 기본
통화는 USD입니다.
가격 필터는 어느 변형이든 하나만 맞으면 됩니다. AliExpress 상품은 가격 범위를 갖는 경우가 많고,
필터는 어느 변형이라도 구간에 들어가면 그 상품을 통과시킵니다 — 그런데 카드에는 최저("부터") 가격이
표시됩니다. 그래서 priceMin=40 요청이 $50짜리 변형 때문에 통과한, $28이 표시되는 행을 돌려줄 수
있습니다. 돌아온 행의 약 90~95%가 구간 안에 들어옵니다. 엄격한 경계가 필요하다면 돌아온 price를 직접
거르세요.
리뷰 오퍼레이션은 없습니다. 상품은 집계 평점(rating.average, rating.count)을 싣지만 리뷰 행은
싣지 않습니다.