Skip to content

京东商品详情 API (V1) ​

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

通过已知商品ID获取京东商品详情。用于在找到其标识符后查看单个商品。

使用提示 ​

支持能力 · 价格

商品价格信息可用。

使用说明 · 属性

提供基本商品属性。使用 V3 或 V4 获取更详细的参数列表。

使用说明 · SKU 选项

提供当前 SKU 信息。使用 V3 或 V4 获取更完整的变体列表。

支持能力 · 主图和轮播图

提供所选 SKU 的主图和轮播图。

适用条件 · 描述图片

专用的描述图片列表和描述 HTML 可能缺失。请使用 V3 获取此内容。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-此 API 服务的访问令牌。
itemIdquerystring是-京东商品的唯一产品标识符(商品ID)。

代码示例 ​

bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/jd/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE'
text
我想使用 JustOneAPI 提供的“商品详情 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/jd/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE
接口地址: BASE_URL + /api/jd/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/jdcom/product-details-v1-zh.json

请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- itemId (query): 京东商品的唯一产品标识符(商品ID)。 (必填)

返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。

响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
   - 0: 成功
   - 100: Token 无效或已失效
   - 301: 采集失败,请重试
   - 302: 超出速率限制
   - 303: 超出每日配额
   - 400: 参数错误
   - 500: 内部服务器错误
   - 600: 权限不足
   - 601: 账户余额不足
   - 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。

请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。
python
import requests

BASE_URL = "https://api.justoneapi.com"  # 由 OpenAPI servers 提供

url = BASE_URL + "/api/jd/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
js
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/jd/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
        final String url = BASE_URL + "/api/jd/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
go
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/api/jd/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/jd/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}

返回字段 ​

业务成功时(code = 0)的主要返回字段。

商品概要7 个字段

data.product

当前 SKU 的商品信息。

字段类型说明
skuIdstring以文本返回的当前 SKU ID。
skuNamestring当前 SKU 的展示标题。
productIdstring当前 SKU 返回的商品 ID。
realSpuIdstring当前 SKU 返回的 SPU 标识,以文本表示。
brandIdstring以文本返回的品牌 ID。
brandNamestring商品返回的品牌名称。
sellPointstring该 SKU 展示的卖点文案。
规格与类目14 个字段

data.product

字段类型说明
modelstring当前 SKU 返回的型号信息。
colorstring当前 SKU 返回的颜色标签。
sizestring当前 SKU 返回的尺码标签。
salesAttrstring随当前 SKU 返回的销售属性文本。
categorystring以原有文本格式返回的类目层级。
cat1string以文本返回的一级类目 ID。
cat2string以文本返回的二级类目 ID。
cat3string以文本返回的三级类目 ID。
upcstring商品返回的 UPC 条码文本。
productAreastring当前 SKU 返回的商品地区标签。
heightstring以文本返回的商品高度值。
lengthstring以文本返回的商品长度值。
widthstring以文本返回的商品宽度值。
weightstring以文本返回的商品重量值。
商品状态6 个字段

data.product

字段类型说明
skuStatusstring以文本返回的 SKU 状态代码。
isDeletestringSKU 信息中返回的删除状态值。
skuTypeinteger平台返回的数值型 SKU 类型代码。
productTypeinteger平台返回的数值型商品类型代码。
saleDatestring以文本返回的销售日期和时间值。
jdexpressboolean商品信息是否标记为京东配送。
图片与视频4 个字段

data

字段类型说明
product.imageurlstring接口返回的商品主图字段。
product.mainImagesarray随商品返回的轮播图条目。
product.mainImages[]string一项商品轮播图条目。
mainVideoIdstring可用时以文本返回的商品主视频 ID。
价格展示7 个字段

data

字段类型说明
priceFloorobject该商品返回的价格展示信息。
priceFloor.pricestring以原有文本格式返回的展示价格。
priceFloor.typestring该价格展示项返回的类型代码。
priceFloor.extobject该商品返回的补充价格信息。
priceFloor.ext.jdPricestring补充价格信息中以文本返回的京东价格值。
commonInfoobject随商品详情返回的通用展示信息。
commonInfo.priceLoginTextstring价格展示关联的登录提示文案。
库存与配送6 个字段

data.stock

当前 SKU 返回的库存与配送信息。

字段类型说明
skuIdstring库存信息中以文本返回的 SKU ID。
realSkuIdstring库存信息以文本返回的实际 SKU ID。
StockStateinteger当前 SKU 返回的数值型库存状态代码。
codeinteger随库存信息返回的数值型结果代码。
isJDexpressboolean库存信息是否标记为京东配送。
promiseResultstring随库存信息返回的配送承诺文案。
店铺与卖家21 个字段

data

字段类型说明
product.shopIdstring商品信息以文本返回的京东店铺 ID。
product.venderIdstring商品信息以文本返回的京东卖家 ID。
stock.Dobject随库存信息返回的卖家资料。
stock.D.venderIdinteger该卖家记录以整数返回的京东卖家 ID。
stock.D.venderstring该卖家记录展示的卖家名称。
stock.D.shopIdinteger该卖家记录以整数返回的京东店铺 ID。
stock.D.shopNamestring京东店铺名称。
stock.D.shopWebsitestring接口返回的该卖家的店铺网站链接。
stock.D.urlstring随该卖家记录返回的店铺链接。
stock.self_Dobject库存信息返回的另一个卖家资料字段。
stock.self_D.venderIdinteger该卖家记录以整数返回的京东卖家 ID。
stock.self_D.venderstring该卖家记录展示的卖家名称。
stock.self_D.shopIdinteger该卖家记录以整数返回的京东店铺 ID。
stock.self_D.shopNamestring京东店铺名称。
stock.self_D.shopWebsitestring接口返回的该卖家的店铺网站链接。
stock.self_D.urlstring随该卖家记录返回的店铺链接。
shopFloorobject可用时返回的店铺展示信息。
shopFloor.shopFloorConfigobject店铺区域的展示信息。
shopFloor.shopFloorConfig.shopTypestring随店铺展示信息返回的店铺类型标签。
shopFloor.shopFloorConfig.shopTypeDescstring返回的店铺类型展示说明。
shopFloor.shopFloorConfig.coverLogostring店铺封面的标识图片。
服务保障20 个字段

data.stock

字段类型说明
irarray随库存信息返回的服务标签。
ir[]object一项关联当前 SKU 的服务标签。
ir[].showNamestring服务标签的展示名称。
ir[].iconTipstring服务标签的提示文案。
ir[].picUrlstring服务标签返回的图片地址。
ir[].helpLinkstring服务标签返回的帮助链接。
promiseYXobject随库存信息返回的配送保障展示信息。
promiseYX.showNamestring配送保障的展示名称。
promiseYX.iconTipstring配送保障的提示文案。
promiseYX.picUrlstring配送保障返回的图片地址。
promiseYX.helpLinkstring配送保障返回的帮助链接。
unifiedServiceTagobject随商品库存详情返回的服务标签信息。
unifiedServiceTag.enableboolean返回的服务标签信息是否标记为启用。
unifiedServiceTag.tsfwarray统一服务标签信息包含的服务标签。
unifiedServiceTag.tsfw[]object统一服务标签列表中的一项。
unifiedServiceTag.tsfw[].namestring该条目返回的服务名称。
unifiedServiceTag.tsfw[].descstring该条目返回的服务说明。
unifiedServiceTag.tsfw[].shortDescstring该条目返回的服务简述。
unifiedServiceTag.tsfw[].logoUrlstring该服务返回的标识图地址。
unifiedServiceTag.tsfw[].helpUrlstring该服务返回的帮助地址。
提示与分享10 个字段

data

字段类型说明
noticeFloorarray随商品详情返回的展示提示。
noticeFloor[]object当前商品的一项展示提示。
noticeFloor[].typestring该提示返回的类型代码。
noticeFloor[].descstring提示的展示文案。
noticeFloor[].statusstring可用时随提示返回的状态值。
noticeFloor[].iconsarray随该提示返回的图标条目。
noticeFloor[].icons[]string一项随提示返回的图标条目。
shareInfoobject该商品返回的分享信息。
shareInfo.titlestring用于分享商品的标题。
shareInfo.shortTitlestring可用时返回的简短分享标题。
查询状态3 个字段

data

当前京东 SKU 的详情。仅返回查询状态时,结果可以包含请求的商品 ID 和提示信息。

字段类型说明
areaIdstring随商品详情返回的地区代码。
itemIdstring仅返回查询状态时带回的请求商品 ID。
msgstring随查询结果返回的状态提示。

响应示例 ​

正在加载响应示例…