1688 상품 상세 정보 API

Q: 구간별 가격은 어떻게 읽나요?

price_tiers에는 수량 구간별 단가가 나열되며, 많이 살수록 단가가 내려갑니다. min_order_quantity는 최소 주문 수량, unit은 가격 단위입니다. 비용을 추산하려면 계획한 수량이 속하는 구간을 찾으십시오.

Q: 제조업체와 무역회사는 어떻게 구분하나요?

supplier_type은 공급업체가 제조업체인지 무역회사인지 알려 줍니다. supplier_founded_year, supplier_fans, supplier_favorited_count와 함께 보면 공급업체의 운영 기간과 받는 관심도를 판단할 수 있습니다.

Q: 재고 데이터가 없는 옵션은 품절인가요?

꼭 그렇지는 않습니다. skus의 옵션, 가격, 재고, 구매 가능 여부는 플랫폼에 명시된 경우에만 반환되므로, 값이 비어 있어도 품절은 아닙니다. 상품 전체의 재고는 is_out_of_stock으로 확인하십시오. 동기 호출에서는 stock, positive_rate, supports_dropship 및 기타 필드(카테고리, 리뷰, 서비스, 공급업체 프로필, 옵션 크기와 무게 등이며 필드 목록에 모두 나와 있습니다)가 비어 있을 수 있습니다. 이 필드가 필요하면 비동기 호출을 사용하십시오.

POST

API 상태

24시간 상태: 99%
24시간 평균 소요 시간: 37.62 s

양호 / 정상
사용 가능
제한적
대부분 작동 중단

양호

최근 24시간

최근 30일

상품 링크나 숫자 offerId로 1688 상품 하나를 가져옵니다. 수량별 단가, 최소 주문 수량, 재고, 옵션, 사양, 이미지, 판매자 정보가 포함됩니다. price_tiers는 수량이 늘어날수록 단가가 낮아지는 구간이며, 옵션 필드가 없다고 해서 해당 옵션이 품절이라는 뜻은 아닙니다.

1688 상품 상세 기능은 도매 상품 하나의 공개 레코드 전체를 읽어옵니다. 가격 범위와 구간별 가격, 최소 주문 수량과 가격 단위, 재고와 판매량, 옵션 상세, 평점과 긍정 리뷰 비율, 이미지, 그리고 공급업체의 이름, 유형, 설립 연도, 팔로워 수와 즐겨찾기 수, 샘플 및 드롭쉬핑 제공 여부가 포함됩니다. 이 공급업체에서 구매하는 것이 합리적인지 판단할 때 사용하며, 구매 검토와 공급업체 비교에 활용할 수 있습니다.

url에는 1688 상품 링크, 상품 링크가 정확히 하나 포함된 공유 텍스트, 또는 숫자 오퍼 ID를 넣을 수 있습니다. 상점 홈페이지와 검색 페이지는 거부됩니다. 가격은 수량이 늘수록 단가가 내려가는 price_tiers로 확인하십시오. positive_rate는 백분율이 아니라 0에서 1 사이의 비율입니다. skus의 옵션, 가격, 재고는 플랫폼에 명시된 경우에만 나타나므로, 값이 없다고 해서 품절을 의미하지는 않습니다.

요금은 요청 1,000개당 $1.39(호출당 $0.001389)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 동기 방식입니다. 오래 걸리는 작업은 요청 본문에 "mode": "async"를 추가하고 job_id를 받아 폴링하세요.

AI 프롬프트

EveryInfra 1688 상품 상세 정보 엔드포인트(alibaba1688/product_detail)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 alibaba1688, action은 product_detail로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
- url: product_detail에는 detail.1688.com 또는 m.1688.com의 상품 URL, 상품 URL이 정확히 하나 포함된 공유 메시지, 또는 숫자 offerId를 사용하세요. qr.1688.com 공유 링크는 상품 페이지로 안전하게 연결되는 경우에만 허용됩니다. 상점 페이지와 검색 페이지는 거부됩니다.
- 단일 객체를 반환합니다. 주요 필드: id, url, title, text, price_min (가격 범위의 하한), price_max (가격 범위의 상한), currency, price_tiers (구간별 가격: 주문 수량이 늘수록 단가가 내려갑니다), min_order_quantity (최소 주문 수량(MOQ)), stock (재고), sold_count (판매 수량), category (플랫폼 자체 분류 체계의 카테고리 이름으로, 플랫폼 간에 정규화되지 않…); 전체 필드 68개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688.
- 요청 본문 예시:
{
"platform": "alibaba1688",
"action": "product_detail",
"params": {
"url": "https://detail.1688.com/offer/873514490218.html"
}
}
- 요금: 요청 1,000개당 $1.39. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.

코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.

요청 파라미터

이름	위치	타입	필수	기본값	설명
`Authorization`	header	`string`	예	-	Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요.
`platform`	body	`string`	예	`alibaba1688`	플랫폼 식별자이며 고정값입니다.
`action`	body	`string`	예	`product_detail`	기능 식별자이며 고정값입니다.
`url`	body.params	`string`	예	-	product_detail에는 detail.1688.com 또는 m.1688.com의 상품 URL, 상품 URL이 정확히 하나 포함된 공유 메시지, 또는 숫자 offerId를 사용하세요. qr.1688.com 공유 링크는 상품 페이지로 안전하게 연결되는 경우에만 허용됩니다. 상점 페이지와 검색 페이지는 거부됩니다.

코드 샘플

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "alibaba1688",
  "action": "product_detail",
  "params": {
    "url": "https://detail.1688.com/offer/873514490218.html"
  }
}'

OpenAPI 정의(JSON)샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.

응답 예시

실제 응답

October 13, 2026 at 04:57(UTC)에 위 코드 샘플의 파라미터로 이 API를 호출해 수집한 응답입니다. results와 count는 해당 호출의 실제 응답이며, 개인정보(이름, 핸들, 아바타, 프로필 링크, 연락처)는 제거했습니다. id, billing, quota는 호출할 때마다 달라지므로 형태만 표시합니다.

json

{
  "id": "req_…",
  "platform": "alibaba1688",
  "action": "product_detail",
  "results": {
    "id": "•••",
    "url": "https://detail.1688.com/offer/873514490218.html",
    "title": "跨境专供Pro6蓝牙耳机真无线入耳式超长续航tws运动无线蓝牙耳机",
    "price_min": 7.1,
    "price_max": 13.8,
    "currency": "CNY",
    "min_order_quantity": 2,
    "stock": 7682692,
    "sold_count": 16813,
    "category": "蓝牙耳机",
    "unit": "条",
    "supplier_name": "深圳高耳基科技有限公司",
    "supplier_fans": "582",
    "supplier_type": "normal_factory",
    "supplier_favorited_count": 582,
    "supports_dropship": {
      "enabled": false,
      "consignPrice": null,
      "consignPriceTiers": [],
      "channels": [],
      "channelDetails": [],
      "protections": [],
      "downstreamPerformance": null,
      "metrics": {
        "orders30d": null,
        "orders7d": null,
        "pickupRate48h": null,
        "pickupRate24h": null,
        "distributorCount": null,
        "downstreamStoreCount": null,
        "publishDate": null
      }
    },
    "supports_sampling": false,
    "is_out_of_stock": false,
    "skus": [
      {
        "id": "•••",
        "name": "Pro6蓝牙耳机  紫色",
        "options": {
          "颜色": "Pro6蓝牙耳机  紫色"
        },
        "price": 7.6,
        "original_price": 7.6,
        "stock": 665434,
        "available": true,
        "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ngwdIg1fNlJ87ZHWL_!!2218564053995-0-cib.jpg"
      },
      {
        "id": "•••",
        "name": "八代蓝牙耳机简配",
        "options": {
          "颜色": "八代蓝牙耳机简配"
        },
        "price": 9.6,
        "original_price": 9.6,
        "stock": 666024,
        "available": true
      },
      {
        "id": "•••",
        "name": "Pro6蓝牙耳机 粉色",
        "options": {
          "颜色": "Pro6蓝牙耳机 粉色"
        },
        "price": 7.6,
        "original_price": 7.6,
        "stock": 664567,
        "available": true,
        "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01VHBm431fNlJGJw3Jm_!!2218564053995-0-cib.jpg"
      }
    ],
    "images": [
      "https://cbu01.alicdn.com/img/ibank/O1CN01RrMK531fNlLKVri2p_!!2218564053995-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01oiS7FO1fNlJFcPVcJ_!!2218564053995-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN019hrirk1fNlJGpWQke_!!2218564053995-0-cib.jpg"
    ],
    "description_images": [
      "https://cbu01.alicdn.com/img/ibank/O1CN01xDu8VE1fNlOMt4i8Z_!!2218564053995-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01mTmUSS1fNlONCMZWr_!!2218564053995-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01myoX5I1fNlONcSew0_!!2218564053995-0-cib.jpg"
    ],
    "video_url": "https://cloud.video.taobao.com/play/u/2218564053995/p/2/e/6/t/1/482069395965.mp4",
    "specs": [
      {
        "name": "芯片类型",
        "value": "中科蓝讯"
      },
      {
        "name": "功能",
        "value": "防水,降噪,呼吸灯,超长续航,通话功能,语音控制,支持音乐,数显屏幕,电竞低延迟"
      },
      {
        "name": "续航时间",
        "value": "0-4小时"
      }
    ],
    "rating": 4.7,
    "review_count": 20,
    "positive_rate": 0.95,
    "sold_display": "已售2.2万+件",
    "want_buy_count": 127,
    "category_path": "数码、电脑 > 手机配件 > 蓝牙耳机",
    "services": [
      "7天无理由退货",
      "晚发必赔"
    ],
    "winport_url": "https://winport.1688.com/page/index.html?memberId=b2b-2218564053995870c8&_tabId_=index&upstreamSource=od&offerId=873514490218",
    "platform": "1688",
    "rating_scale": 5
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

응답 필드

비즈니스 데이터는 results에 담깁니다. 아래 표는 레코드에 포함될 수 있는 필드를 나열하며, 플랫폼에 표시되지 않는 값을 임의로 만들어 넣지 않습니다.

필드	의미
`id`	플랫폼에서 레코드의 고유 ID입니다. 한 플랫폼 안에서만 고유하며, 플랫폼이 다르면 ID가 중복될 수 있습니다.
`url`	플랫폼에서 해당 레코드로 연결되는 링크입니다.
`title`	제목입니다. 플랫폼에 제목이 없으면 null입니다(예: 텍스트 전용 게시물).
`text`	HTML을 제거한 본문으로, 잘리지 않고 전체가 반환됩니다(일부 플랫폼은 목록 결과 자체에 발췌문만 포함되며, 이 경우 해당 플랫폼의 필드 설명에 명시되어 있습니다).
`price_min`	가격 범위의 하한.
`price_max`	가격 범위의 상한.
`currency`	가격의 통화 코드입니다(예: CNY, USD). price는 있는데 currency가 null이면 통화를 추정하지 마세요.
`price_tiers`	구간별 가격: 주문 수량이 늘수록 단가가 내려갑니다. 각 구간은 최소 수량과 함께 확인합니다.
`min_order_quantity`	최소 주문 수량(MOQ). 1688 도매 구매의 첫 번째 관문이므로 가장 먼저 확인해야 합니다.
`stock`	재고. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`sold_count`	판매 수량.
`category`	플랫폼 자체 분류 체계의 카테고리 이름으로, 플랫폼 간에 정규화되지 않았습니다. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`unit`	가격 단위(개, 건, 박스 등).
`supplier_name`	공급업체 이름.
`supplier_fans`	공급업체 팔로워 수. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`supplier_founded_year`	공급업체 설립 연도.
`supplier_type`	공급업체 사업 형태(예: 제조업체, 도매업체).
`supplier_favorited_count`	공급업체가 즐겨찾기에 추가된 횟수. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`supports_dropship`	공급업체가 단품을 대신 발송해 주는지(드롭쉬핑) 여부. 재고 없이 판매할 때 핵심 필터입니다. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`supports_sampling`	공급업체의 샘플 제공 여부. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`is_out_of_stock`	상품 품절 여부. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`skus`	제공되는 경우의 옵션(SKU) 상세 정보. 각 행의 옵션, 가격, 재고, 구매 가능 여부는 플랫폼 데이터에 명시된 경우에만 반환되며, 값이 없다고 해서 품절을 의미하지는 않습니다. 상품 상세 정보에서는 동기 호출 시 다음 옵션 필드가 비어 있을 수 있습니다: weight_g, length_cm, width_cm, height_cm, volume_cm3, image_url, original_price. 필요하면 비동기 호출을 사용합니다.
`images`	페이지 순서대로 나열된 상품 대표 이미지 링크. product_detail에서는 일부 상품 정보에 옵션(SKU) 이미지도 포함되며, 상세 설명 영역의 이미지는 description_images에 있습니다. 이미지가 없으면 생략됩니다.
`description_images`	상품 정보의 원래 순서대로 나열된 상세 설명 이미지 URL 목록. 상품 정보에 없으면 null입니다.
`video_url`	상품 동영상 URL(상품 정보에 동영상이 있는 경우).
`specs`	상품 사양표: {name, value} 쌍의 목록(예: Material: TPU). 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`rating`	상품 종합 평점(1-5). 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`rating_scale`	같은 행에 있는 rating의 최댓값: 5점 척도는 5, 10점 척도는 10입니다. 행에 rating이 있을 때만 제공됩니다. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`review_count`	총 리뷰 수. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`positive_rate`	0-1 비율로 나타낸 호평률(0.999 = 99.9%). 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`sold_display`	원래 표시된 그대로의 판매량(중국어 원문, 예: 100k+ sold). 숫자 값은 sold_count를 사용합니다. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`want_buy_count`	해당 상품에 구매 의사를 표시한 구매자 수(소싱 수요 지표). 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`category_path`	단계별 이름이 중국어로 된 전체 카테고리 경로(예: Digital > Phone accessories > Phone case, 실제로는 원문 언어로 표시). 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`services`	상품 정보의 서비스 라벨(예: 무료 반품 배송, 배송 지연 보상). 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`promotions`	현재 진행 중인 프로모션 이름.
`customization_supported`	공급업체가 맞춤 제작(커스텀 디자인, 샘플 제작)을 지원하는지 여부. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`winport_url`	공급업체의 1688 스토어 링크.
`city`	플랫폼 언어로 된 도시 이름으로, 정규화되지 않았습니다. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`province`	공급업체 소재 성(省). 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`supplier_years`	공급업체가 1688 플랫폼에 입점한 연수. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`package_dimensions`	플랫폼 자체의 의미를 따름
`coupons`	플랫폼 자체의 의미를 따름
`promotion_details`	플랫폼 자체의 의미를 따름
`service_details`	서비스 보장 상세 정보: code(서비스 코드), name, description(규칙 내용), rule_url(규칙 페이지). services / service_tags에는 이름만 들어 있습니다. 상품 상세에서는 동기 호출 시 비어 있을 수 있으므로, 필요한 경우 비동기 호출을 사용하세요.
`purchase_limits`	플랫폼 자체의 의미를 따름
`mix_wholesale`	플랫폼 자체의 의미를 따름
`supports_mix`	플랫폼 자체의 의미를 따름
`review_tags`	구매자 인상 태그: [{tag, count}]. 예: “부드러운 원단” ×2. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`refund_rate`	플랫폼 자체의 의미를 따름
`review_negative_count`	플랫폼 자체의 의미를 따름
`review_neutral_count`	플랫폼 자체의 의미를 따름
`review_with_photo_count`	사진이 포함된 리뷰 수. null은 0이 아니라 제공되지 않았다는 뜻입니다. 상품 상세 정보에서는 동기 호출 시 비어 있을 수 있으므로, 필요하면 비동기 호출을 사용합니다.
`review_with_text_count`	텍스트가 포함된 리뷰 수입니다. null은 0이 아니라 값이 제공되지 않았음을 의미합니다. 상품 상세에서는 동기 호출 시 비어 있을 수 있으므로, 필요한 경우 비동기 호출을 사용하세요.
`supplier_stats`	공급업체 프로필(값이 있는 키만 포함): employee_count, plant_area_sqm(공장 면적, m²), plant_type(예: 자체 공장), equipment_count(주요 설비 수), product_count(판매 중인 상품 수), repeat_rate(재구매자 비율, 0-1), repeat_buyer_count_text / cross_border_buyer_count_text(표시된 재구매자 및 해외 구매자 수, 예: 300+), response_rate(0-1), positive_review_rate(0-1), fulfillment_rate(0-1), certificate_count / certificates / management_certificates(인증서 수, 인증서 이름, 경영 시스템 인증), patent_count, oem_mode(OEM/ODM), own_brands(표시된 자체 브랜드), brand_count, partner_brand, is_major_brand_partner(대형 브랜드 납품 여부), scale_tier(규모 등급), honors. 상품 상세에서는 동기 호출 시 비어 있을 수 있으므로, 필요한 경우 비동기 호출을 사용하세요.
`supplier_scores`	플랫폼 자체의 의미를 따름
`supplier_metric_tags`	플랫폼 자체의 의미를 따름
`supplier_rank`	플랫폼 자체의 의미를 따름
`supplier_industry_belt`	산업 클러스터 인증: description(예: 1688이 인증한 지역 의류 클러스터의 플래그십 판매자), link_url(인증 페이지). 상품 상세에서는 동기 호출 시 비어 있을 수 있으므로, 필요한 경우 비동기 호출을 사용하세요.
`supplier_certification`	제3자 공장 또는 사업자 심사 정보: agency(sgs, tuv 등 심사 기관 코드), report_number(표시된 보고서 번호), report_url(보고서 페이지). 상품 상세에서는 동기 호출 시 비어 있을 수 있으므로, 필요한 경우 비동기 호출을 사용하세요.
`supplier_verification_tags`	플랫폼 자체의 의미를 따름
`supplier_inspection_report_url`	플랫폼 자체의 의미를 따름
`supplier_videos`	플랫폼 자체의 의미를 따름
`supplier_address`	화면에 표시된 공급업체 주소입니다. 상품 상세에서는 동기 호출 시 비어 있을 수 있으므로, 필요한 경우 비동기 호출을 사용하세요.
`supplier_coordinates`	공급업체 위치: {longitude, latitude}. 상품 상세에서는 동기 호출 시 비어 있을 수 있으므로, 필요한 경우 비동기 호출을 사용하세요.
`supplier_main_category`	공급업체의 주요 카테고리입니다. 상품 상세에서는 동기 호출 시 비어 있을 수 있으므로, 필요한 경우 비동기 호출을 사용하세요.
`customization`	플랫폼 자체의 의미를 따름
`shipping`	플랫폼 자체의 의미를 따름
`unit_weight_kg`	플랫폼 자체의 의미를 따름
`platform`	출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok).

FAQ

구간별 가격은 어떻게 읽나요?

price_tiers에는 수량 구간별 단가가 나열되며, 많이 살수록 단가가 내려갑니다. min_order_quantity는 최소 주문 수량, unit은 가격 단위입니다. 비용을 추산하려면 계획한 수량이 속하는 구간을 찾으십시오.

제조업체와 무역회사는 어떻게 구분하나요?

supplier_type은 공급업체가 제조업체인지 무역회사인지 알려 줍니다. supplier_founded_year, supplier_fans, supplier_favorited_count와 함께 보면 공급업체의 운영 기간과 받는 관심도를 판단할 수 있습니다.

재고 데이터가 없는 옵션은 품절인가요?

꼭 그렇지는 않습니다. skus의 옵션, 가격, 재고, 구매 가능 여부는 플랫폼에 명시된 경우에만 반환되므로, 값이 비어 있어도 품절은 아닙니다. 상품 전체의 재고는 is_out_of_stock으로 확인하십시오. 동기 호출에서는 stock, positive_rate, supports_dropship 및 기타 필드(카테고리, 리뷰, 서비스, 공급업체 프로필, 옵션 크기와 무게 등이며 필드 목록에 모두 나와 있습니다)가 비어 있을 수 있습니다. 이 필드가 필요하면 비동기 호출을 사용하십시오.

오류 및 과금

401: 키가 없거나 유효하지 않습니다.
402: 잔액이 부족합니다. 먼저 충전하세요.
422: 파라미터 이름 또는 값이 올바르지 않습니다. 오류에 제시된 제안을 참고해 수정하세요. 과금되지 않습니다.
429: 분당 요청 속도 제한에 도달했습니다. Retry-After만큼 기다린 뒤 다시 시도하세요.
503: 처리를 완료하지 못했습니다. 보류된 금액은 잔액으로 반환됩니다. 결과가 불확실하면 재시도하기 전에 먼저 확인하세요.
200 빈 결과: 데이터가 없습니다. 과금되지 않습니다.

오류

공식 참고 자료

객체와 용어를 확인하는 용도로만 사용합니다. 해당 플랫폼이 EveryInfra를 승인하거나 보증한다는 의미는 아닙니다.

1688: 상품, 규격, 최소 주문 수량 ↗
1688 구매 문서는 상품 offerId, 규격 specId, 구매 수량을 구분하고 최소 주문 수량을 별도로 검증합니다. 이 용어들은 설명 목적으로만 인용하며, 이 엔드포인트는 구매 주문을 생성하거나 미리 보는 기능을 지원하지 않습니다.
2026-09-04 확인