Product
AliExpress 상품 하나를 가져옵니다: 가격, 재고가 포함된 모든 SKU, 이미지, 사양, 판매자, 그리고 요청 시 배송.
GET | POST /v1/aliexpress/product파라미터는 GET의 쿼리 문자열로도, POST의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.
요청
curl "https://gateway.apinoa.com/v1/aliexpress/product?id=1005012583726882" \
-H "x-api-key: $APINOA_API_KEY"파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
id | string | 예 | AliExpress product id, as carried by a search item. |
currency | string | Presentment currency. | |
include | enum | include=shipping adds delivery: the cheapest shipping cost and delivery days to region for the product's listed variant. Costs one more unit. shipping | |
language | string | Presentment language. | |
region | string | Buyer country (ISO 3166-1 alpha-2). |
같은 파라미터와 모든 응답 타입은 OpenAPI 문서에도 있습니다.
응답
data에 Product를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.
{
"data": {
"marketplace": "aliexpress",
"id": "1005012583726882",
"url": "https://www.aliexpress.com/item/1005012583726882.html",
"title": "New Floating Airbag Waterproof Swimming Bag Phone Case For iPhone Samsung Xiaomi Redmi Huawei Google OPPO Vivo Phone Co…",
"price": {
"currency": "USD",
"amount": 2.25
},
"listPrice": {
"currency": "USD",
"amount": 4.5
},
"brand": "GOT-TOG",
"rating": {
"average": 0
},
"seller": {
"id": "1105627229",
"name": "Shop1105624218 Store",
"country": "CN",
"ext": {
"detailedRatings": {
"itemAsDescribed": 4.5,
"communication": 4.7,
"shippingSpeed": 4.7
}
}
},
"salesCount": 2,
"salesLabel": "2",
"inStock": true,
"delivery": {
"handlingDays": 7
},
"stock": 39,
"badges": [],
"promotions": [],
"attributes": [
{
"name": "High-concerned chemical",
"value": "none"
},
{
"name": "Origin",
"value": "Mainland China"
}
],
"description": "<p><img src=\"https://ae-pic-a1.aliexpress-media.com/kf/S3541bd22822b4ded8745118983aa6c485.jpg\" slate-data-type=\"image\"/…",
"features": [],
"media": {
"images": [
"https://ae01.alicdn.com/kf/Se9739ac4e32a46deaae06bba6a6d0003l.jpg",
"https://ae01.alicdn.com/kf/Sa167b127f8bb44cd85473d9928d486c5G.jpg"
],
"videos": []
},
"category": [
{
"name": "Luggage & Bags"
},
{
"name": "Special Purpose Bags"
}
],
"options": [
{
"id": "14",
"name": "Color",
"values": [
{
"id": "193",
"name": "black",
"imageUrl": "https://ae01.alicdn.com/kf/S3541bd22822b4ded8745118983aa6c485.jpg"
}
]
}
],
"variants": [
{
"id": "12000058743753115",
"price": {
"currency": "USD",
"amount": 2.25
},
"listPrice": {
"currency": "USD",
"amount": 4.5
},
"inStock": true,
"stock": 39,
"selections": [
{
"optionId": "14",
"valueId": "193",
"optionName": "Color",
"valueName": "black"
}
],
"ext": {
"taxIncluded": false
}
}
],
"offers": [],
"reviewAspects": [],
"boxContents": [],
"reviews": [],
"package": {
"weightKg": 0.043,
"ext": {
"heightCm": 1,
"lengthCm": 23,
"soldInLot": false,
"widthCm": 16
}
},
"ext": {
"wholesale": false
}
},
"requestId": "6fc82fad9e5249c1b0bccff6aede0c73",
"success": true
}에러
| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | INVALID_PARAMS | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났습니다. 메시지에 이름이 나옵니다. |
| 401 | UNAUTHORIZED | x-api-key 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | INSUFFICIENT_BALANCE | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 404 | ITEM_NOT_FOUND | AliExpress에 해당 상품이 없습니다. |
| 503 | TOKEN_EXPIRED | AliExpress를 잠시 사용할 수 없습니다. 나중에 다시 시도하세요. |
모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.
가격
가격 호출당 $0.001, 추가 호출마다 $0.001 — 최대 1번 더, 합계 최대 $0.002. 정가 기준이며, 하루 1,000회를 넘으면 단가가 내려갑니다.
참고
- 검색 항목의
id를 그대로 이어서 넘길 수 있습니다. include=shipping은 가격이 표시된 변형의region까지의 배송을 추가합니다:delivery는 가장 저렴한 옵션이고(가격에delivery.cost를 더한 것이 배송 포함 가격),shippingOptions는 견적된 모든 옵션을 저렴한 순으로 나열합니다. 호출이 2단위가 됩니다. Shipping은 어떤 변형이든 단독으로 견적합니다.