万邦api博客

技术入门：YouTube视频详情接口快速对接与JSON实战

Mon, 03 Aug 2026 15:29:09 +0800

在海外内容分析、短视频素材聚合、创作者数据监控这类场景里，YouTube视频详情接口是最核心的基础数据入口。不用自己搭建复杂的海外爬虫和代理池，就能稳定获取全维度的结构化视频数据，哪怕是新手开发者也能快速完成对接落地。

一、接口核心覆盖的数据范围

这个接口能返回海外内容业务需要的几乎所有核心视频字段，完全适配内容分析、竞品监控、素材采集等场景：

基础标识：视频唯一VideoID、标题、所属频道ID、频道名称、视频发布时间、视频分类标签
互动数据：播放量、点赞数、点踩数、总评论数，数据做到分钟级更新
内容属性：视频时长、是否高清、是否带字幕、是否是直播回放、视频语言标识
素材资源：多尺寸封面图数组、视频内嵌播放地址、字幕文件下载链接
评论模块：支持分页获取一级评论、评论回复，每条评论附带发布者ID、点赞数、发布时间
附加信息：视频标签列表、官方简介、地区可访问性、版权声明状态

二、最简接入操作步骤

新手跟着3步就能完成基础调用，没有复杂的前置依赖：

注册Google Cloud开发者账号，在API库中启用YouTube Data API v3服务，创建应用后获取专属的API Key（o0b.cn/anzexi）
构造请求URL，把part参数指定为你需要返回的字段模块（比如snippet、statistics、contentDetails），同时传入目标视频的VideoID
用标准HTTP GET方式提交请求，官方网关会直接返回标准JSON格式的结构化视频数据，无需额外复杂鉴权

三、可直接参考的成功返回JSON示例

这是脱敏后的标准返回结构，核心字段都标注了业务含义，完全匹配官方原生返回格式，可直接用于开发调试参考：

json
{
  "kind": "youtube#videoListResponse",
  "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/XwZ123abcDEF456\"",
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 1
  },
  "items": [
    {
      "kind": "youtube#video",
      "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\"",
      "id": "dQw4w9WgXcQ",
      "snippet": {
        "publishedAt": "2009-10-25T06:57:33Z",
        "channelId": "UCuAXFkgswL42KnjU898b0vA",
        "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
        "description": "The official video for \"Never Gonna Give You Up\" by Rick Astley",
        "thumbnails": {
          "default": {
            "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg",
            "width": 120,
            "height": 90
          },
          "medium": {
            "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg",
            "width": 320,
            "height": 180
          },
          "high": {
            "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
            "width": 480,
            "height": 360
          }
        },
        "channelTitle": "Rick Astley",
        "tags": ["Rick Astley", "Never Gonna Give You Up", "Official Music Video"],
        "categoryId": "10",
        "liveBroadcastContent": "none",
        "defaultAudioLanguage": "en"
      },
      "contentDetails": {
        "duration": "PT3M33S",
        "dimension": "2d",
        "definition": "hd",
        "caption": true,
        "licensedContent": true
      },
      "statistics": {
        "viewCount": "14234567890",
        "likeCount": "125678900",
        "favoriteCount": "0",
        "commentCount": "2345678"
      },
      "status": {
        "uploadStatus": "processed",
        "privacyStatus": "public",
        "embeddable": true,
        "publicStatsViewable": true
      }
    }
  ]
}

技术入门：1688商品详情接口快速对接与JSON实战

Fri, 31 Jul 2026 16:19:23 +0800

在B2B电商开发场景里，1688商品详情接口是供应链系统、分销平台、比价工具的核心数据入口，不用手动编写复杂的页面爬虫，就能稳定获取全维度的结构化商品信息，哪怕是新手开发者也能快速完成对接落地。

一、接口核心覆盖的数据范围

这个接口能返回业务开发中几乎所有需要的B2B专属商品字段，完全适配批发、分销、库存监控等场景：

基础标识：商品唯一ItemID、标题、品牌、所属类目、供应商店铺名称、是否支持一件代发
价格体系：阶梯批发价、代发专属价、近30天成交均价，支持不同采购量的价格分层返回
交易属性：起订量规则、最小采购数、近30天成交笔数、回头率数据
物流信息：发货地、默认运费模板、是否支持包邮、预计发货时效
SKU明细：所有规格的子ID、对应采购价、实时库存、规格属性（颜色/尺寸/材质等）
素材与资质：商品主图组、详情图数组、供应商经营年限、深度验厂标识
分销专属：是否支持跨境代发、48小时发货标识、7天无理由退换货服务标签

二、最简接入操作步骤

新手跟着3步就能完成基础调用，没有复杂的前置依赖：

注册1688开放平台企业开发者账号，创建应用后申请商品详情查询接口权限，获取专属的AppKey和AppSecret
把所有非空请求参数按字典序排序，拼接成连续的键值对字符串，首尾拼接AppSecret后用MD5加密转大写，生成合法的请求签名
用标准HTTP GET方式将参数提交到1688官方API网关，即可直接返回标准JSON格式的结构化商品数据

三、可直接参考的成功返回JSON示例

这是脱敏后的标准返回结构，核心字段都标注了业务含义，可直接用于开发调试参考：

{
  "alibaba_item_get_response": {
    "code": "0",
    "msg": "success",
    "requestId": "req_2026073014250089",
    "data": {
      "itemId": "590347769363",
      "title": "新款磁性软纱门 加密防蚊静音门帘 家用免打孔批发",
      "brand": "家安",
      "category": "家居日用品 > 门帘纱窗",
      "shopName": "家安家居用品工厂店",
      "isDropship": true,
      "detailUrl": "https://detail.1688.com/offer/590347769363.html",
      "priceModel": {
        "minOrderNum": 2,
        "ladderPriceList": [
          {"countStart": 2, "price": "12.50"},
          {"countStart": 50, "price": "11.20"},
          {"countStart": 200, "price": "9.80"}
        ],
        "dropshipPrice": "13.90"
      },
      "salesData": {
        "monthSales": 12600,
        "dealCount30d": 328,
        "repurchaseRate": "28.6%"
      },
      "freightInfo": {
        "deliveryAddress": "安徽省亳州市",
        "isFreeDeliver": false,
        "defaultFreight": 7,
        "deliveryTime": "48小时内发货"
      },
      "skuList": [
        {
          "skuId": "59034776936301",
          "specText": "90*210cm 灰色条纹",
          "skuPrice": "12.50",
          "skuStock": 12600
        },
        {
          "skuId": "59034776936302",
          "specText": "100*220cm 蓝色条纹",
          "skuPrice": "13.20",
          "skuStock": 8900
        }
      ],
      "imageInfo": {
        "mainImgList": [
          "https://cbu01.alicdn.com/img/ibank/O1CN01lXNSbu1R7M8Z7UeSC_!!2963812064-0-cib.jpg",
          "https://cbu01.alicdn.com/img/ibank/O1CN01kLzX7y1KzXqfXqZ7y_!!2963812064-0-cib.jpg"
        ],
        "detailImgList": [
          "https://cbu01.alicdn.com/img/ibank/detail_01.jpg",
          "https://cbu01.alicdn.com/img/ibank/detail_02.jpg"
        ]
      },
      "shopAttr": {
        "openYears": 6,
        "isFactoryVerified": true,
        "serviceTags": ["7天无理由", "48小时发货", "极速退款"]
      },
      "productParams": [
        {"name": "材质", "value": "加密磁性软纱网"},
        {"name": "安装方式", "value": "免打孔魔术贴"},
        {"name": "适用场景", "value": "家用入户门/卧室门"}
      ]
    }
  }
}

四、新手必看的生产级优化技巧

实际项目落地时，几个小调整就能大幅提升接口稳定性和业务效率：

对商品标题、详情图这类静态数据做本地缓存，设置24小时的过期时间，既能降低接口调用频次，也能提升业务系统响应速度
传入sales_data=2参数即可获取订货模式的完整成交数据，传入agent=1可直接返回分销代发的专属价格，不用额外请求其他接口
提前配置异常重试机制，遇到临时网络波动时自动重试2次，避免单次请求失败就中断业务流程

这个接口没有过高的技术门槛，哪怕是刚接触B2B电商开发的新手，对照JSON示例和基础步骤，短时间内就能完成对接，快速把1688的商品数据接入自己的分销系统、供应链管理平台。

技术入门：京东商品详情接口快速上手与JSON实战

Wed, 29 Jul 2026 17:35:13 +0800

做电商相关开发时，京东商品详情接口是最常用的基础工具之一，它不用写复杂爬虫，就能稳定拿到商品的全维度结构化数据，新手也能快速对接落地，是电商数据开发里性价比很高的入门级接口。

一、接口核心能拿到什么数据

这个接口覆盖了电商业务需要的几乎所有核心商品信息，不用自己从页面零散抓取：

基础标识：商品SKU唯一ID、标题、品牌、所属类目、店铺名称、是否京东自营

价格优惠：日常售价、原价、店铺优惠券、券后最终到手价

分销相关：佣金比例、单商品预估佣金，适合CPS带货场景

销量库存：总销量、近30天销量、实时可售库存、商品上架状态

素材资源：商品主图、详情图数组，直接用于铺货、素材采集

SKU明细：不同颜色、尺码的子规格，对应单独的价格和库存数据

二、最简接入步骤

新手跟着3步就能完成基础调用，不用复杂配置：

注册京东开放平台开发者账号，创建应用后申请商品详情查询权限，拿到AppKey和AppSecret两个密钥

把请求参数按字典序排序，拼接后首尾加上AppSecret，用MD5加密转大写生成签名，完成鉴权

用HTTPS POST方式把请求发到官方API网关，就能拿到标准JSON格式的返回数据

三、可直接参考的成功返回JSON示例

这是脱敏后的标准返回结构，核心字段都标注了业务含义，直接复制就能用于开发测试：

{
  "jd_union_open_goods_detail_query_response": {
    "code": "0",
    "msg": "success",
    "requestId": "req_2026072917300012",
    "result": {
      "goodsInfo": {
        "skuId": "100065474274",
        "title": "夏季纯棉宽松短袖女 纯色百搭基础T恤多色可选",
        "brandName": "简禾",
        "categoryName": "女装 > T恤",
        "shopName": "简禾官方旗舰店",
        "isJdSelf": false,
        "itemUrl": "https://item.jd.com/100065474274.html",
        "priceInfo": {
          "originalPrice": "79.90",
          "discountPrice": "59.00"
        },
        "couponInfo": {
          "couponDiscount": "10.00",
          "finalPrice": "49.00",
          "couponDesc": "满59减10店铺优惠券"
        },
        "commissionInfo": {
          "commissionRate": "12.50",
          "commissionMoney": "6.13"
        },
        "salesInfo": {
          "totalSales": 9650,
          "monthSales": 2360
        },
        "stockInfo": {
          "totalStock": 460,
          "isSale": true
        },
        "imageInfo": {
          "mainImg": "https://img.jd.com/imgextra/i1/main.jpg",
          "detailImgList": [
            "https://img.jd.com/imgextra/i1/detail_01.jpg",
            "https://img.jd.com/imgextra/i1/detail_02.jpg"
          ]
        },
        "skuList": [
          {
            "skuId": "10006547427401",
            "specText": "白色 M",
            "skuPrice": "59.00",
            "skuStock": 180
          },
          {
            "skuId": "10006547427402",
            "specText": "黑色 XL",
            "skuPrice": "59.00",
            "skuStock": 125
          }
        ],
        "productParams": [
          {"name": "面料", "value": "100%纯棉"},
          {"name": "版型", "value": "宽松常规"},
          {"name": "适用季节", "value": "夏季"}
        ],
        "commentSummary": {
          "goodRateShow": "96.5",
          "commentCount": 1420
        }
      }
    }
  }
}

四、新手必看的高频问题处理

实际调用时遇到报错不用慌，几个常见问题都有明确解决方案：

code=15 签名校验错误：检查参数排序是否正确，AppSecret有没有写错

code=3005 商品不存在：确认传入的SKU ID是京东平台的有效商品ID

adg t_img - 图片翻译接口系列，json 数据返回

Tue, 28 Jul 2026 17:07:25 +0800

{ "article_title": "ADG t_img 图片翻译接口全解析：从入门到工程化实战", "article_topic": "图片翻译API接口技术指南", "tags": ["图片翻译", "OCR", "API接口", "多语言", "工程化"], "summary": "t_img 是万邦开放平台推出的图片翻译专用接口，集 OCR 文字识别与机器翻译于一体，支持 20+ 语种互译，兼容 JPG/PNG 等主流格式，可保持原图排版布局，广泛应用于跨境电商、文档翻译、截图实时翻译等场景。本文从接口原理、参数详解、返回结构到代码实战，系统梳理 t_img 接口的完整接入方案。", "sections": [ { "section_title": "一、接口概述", "content": "t_img 是图片翻译专用 API 接口，实现了「OCR 文字识别 + 机器翻译 + 版式回填」一体化处理。开发者只需传入图片 URL 或 Base64 编码，指定目标语言，即可一次性获取识别文本、翻译结果以及文字坐标信息，无需手动拼接 OCR 和翻译两个接口。", "key_features": [ "OCR + 翻译一体化，单次调用完成全流程", "支持 20+ 语种互译（中、英、日、韩、法、德、俄、西等）", "兼容 JPG、PNG、BMP、WEBP 等主流图片格式", "返回文字区域坐标（rect/points），支持版式还原", "支持图片 URL 和 Base64 两种传入方式", "内置缓存机制，重复请求响应更快" ] }, { "section_title": "二、接口信息与请求参数", "content": "接口采用 HTTP GET/POST 方式调用，公共参数通过 URL 拼接，业务参数支持 GET 查询串或 POST JSON Body。", "request_info": { "api_name": "translate.t_img", "endpoint": "https://api-gw.onebound.cn/translate/t_img", "method": "GET / POST", "content_type": "application/x-www-form-urlencoded / application/json" }, "public_params": [ {"name": "key", "type": "String", "required": true, "desc": "调用密钥 Key，GET 方式拼接在 URL 中"}, {"name": "secret", "type": "String", "required": true, "desc": "调用密钥 Secret"}, {"name": "api_name", "type": "String", "required": true, "desc": "API 接口名称，固定为 t_img"}, {"name": "result_type", "type": "String", "required": false, "desc": "返回格式：json/jsonu/xml/serialize，默认 json"}, {"name": "lang", "type": "String", "required": false, "desc": "接口说明语言：cn/en/ru，默认 cn"}, {"name": "cache", "type": "String", "required": false, "desc": "是否使用缓存：yes/no，默认 yes"} ], "business_params": [ {"name": "imgcode", "type": "String", "required": true, "desc": "图片地址（URL）或图片 Base64 编码（POST 方式）"}, {"name": "to", "type": "String", "required": true, "desc": "目标语言代码，如 en（英语）、jp（日语）、kor（韩语）等"} ] }, { "section_title": "三、返回数据结构详解", "content": "接口返回 JSON 格式数据，顶层为 items 对象，包含源语言、目标语言以及识别翻译内容列表。每个 content 元素对应图片中一行识别到的文字，包含原文、译文、位置坐标等完整信息。", "response_structure": { "items": { "from": "源语言代码（如 zh）", "to": "目标语言代码（如 en）", "content": [ { "src": "识别到的原始文本", "dst": "翻译后的文本", "rect": "文字区域矩形坐标（x y width height）", "lineCount": "文本行数", "points": "文字区域四角坐标点数组 [{x,y}, ...]", "pasteImg": "回填效果图（Base64，部分场景返回）" } ] } }, "response_example": { "items": { "from": "zh", "to": "en", "content": [ { "src": "恭喜发财", "dst": "May you be happy and prosperous", "rect": "209 3 382 78", "lineCount": 1, "points": [ {"x": 209, "y": 3}, {"x": 589, "y": 3}, {"x": 589, "y": 78}, {"x": 209, "y": 78} ], "pasteImg": "" }, { "src": "小财神", "dst": "Little God of Wealth", "rect": "612 641 157 53", "lineCount": 1, "points": [ {"x": 612, "y": 641}, {"x": 768, "y": 641}, {"x": 768, "y": 692}, {"x": 612, "y": 692} ], "pasteImg": "" } ] } } }, { "section_title": "四、支持语言列表", "content": "t_img 接口覆盖主流语种，常用语言代码对照如下：", "language_codes": [ {"language": "中文", "code": "zh"}, {"language": "英语", "code": "en"}, {"language": "日语", "code": "jp"}, {"language": "韩语", "code": "kor"}, {"language": "法语", "code": "fra"}, {"language": "德语", "code": "de"}, {"language": "西班牙语", "code": "spa"}, {"language": "俄语", "code": "ru"}, {"language": "葡萄牙语", "code": "pt"}, {"language": "意大利语", "code": "it"}, {"language": "荷兰语", "code": "nl"}, {"language": "马来语", "code": "may"}, {"language": "印尼语", "code": "id"}, {"language": "土耳其语", "code": "tr"}, {"language": "波兰语", "code": "pl"}, {"language": "瑞典语", "code": "swe"}, {"language": "丹麦语", "code": "dan"}, {"language": "希腊语", "code": "el"}, {"language": "匈牙利语", "code": "hu"}, {"language": "罗马尼亚语", "code": "rom"} ] }, { "section_title": "五、Python 接入实战", "content": "以下是基于 requests 库的 Python 调用示例，涵盖 URL 图片和 Base64 图片两种传入方式，以及返回结果的结构化解析。", "code_example_python": """import requests import base64 from typing import Dict, List, Any class TImgTranslator: """t_img 图片翻译客户端""" def __init__(self, api_key: str, api_secret: str): self.api_key = api_key self.api_secret = api_secret self.base_url = "https://api-gw.onebound.cn/translate/t_img" def translate_by_url(self, img_url: str, target_lang: str = "en") -> Dict[str, Any]: """通过图片 URL 翻译""" params = { "key": self.api_key, "secret": self.api_secret, "api_name": "t_img", "imgcode": img_url, "to": target_lang, "result_type": "json" } resp = requests.get(self.base_url, params=params, timeout=30) resp.raise_for_status() return resp.json() def translate_by_base64(self, image_path: str, target_lang: str = "en") -> Dict[str, Any]: """通过本地图片 Base64 翻译""" with open(image_path, "rb") as f: img_base64 = base64.b64encode(f.read()).decode() payload = { "key": self.api_key, "secret": self.api_secret, "api_name": "t_img", "imgcode": img_base64, "to": target_lang } resp = requests.post(self.base_url, json=payload, timeout=30) resp.raise_for_status() return resp.json() def extract_translations(self, result: Dict[str, Any]) -> List[Dict[str, str]]: """提取翻译文本对列表""" items = result.get("items", {}) content_list = items.get("content", []) return [ { "original": item.get("src", ""), "translated": item.get("dst", ""), "position": item.get("rect", "") } for item in content_list ] # 使用示例 if __name__ == "__main__": translator = TImgTranslator("your_api_key", "your_api_secret") result = translator.translate_by_url( img_url="https://example.com/test.jpg", target_lang="en" ) translations = translator.extract_translations(result) for t in translations: print(f"原文: {t['original']}") print(f"译文: {t['translated']}") print(f"位置: {t['position']}") print("---")""" }, { "section_title": "六、Java 接入示例", "content": "Java 环境下通过原生 URLConnection 调用接口，解析 JSON 返回结果。", "code_example_java": """import java.io.BufferedReader; import java.io.InputStreamReader; import java.net.URL; import java.net.URLConnection; import java.nio.charset.StandardCharsets; import org.json.JSONObject; import org.json.JSONArray; public class TImgExample { private static final String API_URL = "https://api-gw.onebound.cn/translate/t_img/"; public static JSONObject translateImage(String key, String secret, String imgUrl, String targetLang) throws Exception { String url = API_URL + "?key=" + key + "&secret=" + secret + "&api_name=t_img&imgcode=" + imgUrl + "&to=" + targetLang; URL realUrl = new URL(url); URLConnection conn = realUrl.openConnection(); conn.setConnectTimeout(10000); conn.setReadTimeout(30000); try (BufferedReader rd = new BufferedReader( new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8))) { StringBuilder sb = new StringBuilder(); int cp; while ((cp = rd.read()) != -1) { sb.append((char) cp); } return new JSONObject(sb.toString()); } } public static void main(String[] args) throws Exception { JSONObject result = translateImage( "your_api_key", "your_api_secret", "https://example.com/test.jpg", "en" ); JSONObject items = result.getJSONObject("items"); JSONArray content = items.getJSONArray("content"); System.out.println("源语言: " + items.getString("from")); System.out.println("目标语言: " + items.getString("to")); System.out.println("识别行数: " + content.length()); for (int i = 0; i < content.length(); i++) { JSONObject item = content.getJSONObject(i); System.out.println("原文: " + item.getString("src")); System.out.println("译文: " + item.getString("dst")); } } }""" }, { "section_title": "七、应用场景", "content": "t_img 接口的应用场景覆盖跨境电商、内容平台、工具类产品等多个领域。", "scenarios": [ { "name": "跨境电商商品图翻译", "desc": "批量翻译商品详情图、海报图中的文字，快速适配多语言站点，提升海外用户转化率" }, { "name": "截图实时翻译工具", "desc": "集成到浏览器插件、桌面应用中，实现选区截图即翻译，适合阅读外文文档、网页时使用" }, { "name": "文档图片翻译", "desc": "扫描件、PDF 转图片后批量翻译，保留版式坐标信息，便于还原排版输出" }, { "name": "APP 拍照翻译", "desc": "移动端调用摄像头拍照后上传翻译，应用于旅游翻译、菜单翻译、路牌翻译等场景" }, { "name": "社交媒体内容本地化", "desc": "自动识别并翻译社交媒体图片中的文字，助力内容多语言分发和运营" } ] }, { "section_title": "八、最佳实践与注意事项", "content": "在生产环境接入 t_img 接口时，建议从异常处理、缓存策略、图片预处理等方面做好工程化保障。", "best_practices": [ "图片大小控制在 10MB 以内，过大图片建议先压缩再上传，可显著提升响应速度", "优先使用图片 URL 方式传入，减少请求体大小；本地图片再走 Base64 路径", "开启 cache=yes 利用缓存机制，相同图片重复翻译可大幅降低调用成本和延迟", "对返回的 content 列表做空判断，图片中无文字时 content 可能为空数组", "rect 字段格式为「x y width height」，points 为四角坐标，可根据需要选择使用", "生产环境建议配置超时重试机制，网络波动时自动重试 2-3 次保障成功率", "批量翻译场景建议控制并发数，避免触发频率限制，可结合队列削峰处理", "敏感内容翻译需结合内容安全接口做二次审核，确保合规" ]

京东工业商品详情 API 技术解析｜B2B 工业品数据对接方案（含标准 JSON 返回示例）

Fri, 24 Jul 2026 16:05:55 +0800

一、接口基础概述

接口名称：京东工业单品详情查询接口

区分：京东工业（B2B 工业品）≠京东零售 C 端联盟接口，工业品接口面向企业采购、MRO 物料管理、工业供应链系统，具备含税价、起订量、工业技术参数、交期、资质文件等 B 端独有字段。

网关地址：o0b.cn/anzexi
请求方式：HTTPS POST
返回格式：标准 JSON
鉴权方式：appKey + appSecret MD5 签名 + access_token 授权
核心入参：skuId（工业品唯一 SKU 编码）
接口能力：传入 SKU，获取工业品标题、品牌、工业类目、阶梯采购价、含税单价、起订量、实时库存、多规格 SKU、技术参数、物料交期、质保信息、商品图文。

主流落地业务场景

企业 MRO 采购 ERP：物料库自动同步京东工业货源，实现线上比价、自动寻源
工业供应链集采平台：搭建工业品商城，商品一键采集上架、价格库存持续同步
制造业物料管理系统：备品备件价格监控，采购成本预警
工业品比价工具：批量抓取多品牌物料报价，筛选最优供应商
第三方采购服务商：对接京东工业货源，实现代下单、统一对账

二、标准成功返回 JSON 示例（工业品完整脱敏样例）

{
    "industrial_product_detail_get_response": {
        "code": "0",
        "msg": "success",
        "requestId": "req_202607241510007712",
        "result": {
            "goodsInfo": {
                "skuId": "10200987654321",
                "title": "3M 6200半面型防毒面具 化工防尘防毒面罩",
                "brandName": "3M",
                "categoryName": "安全防护 > 呼吸防护 > 防毒面具",
                "shopName": "3M工业自营旗舰店",
                "isJdIndustrialSelf": true,
                "itemUrl": "https://item.jd.com/10200987654321.html",
                "priceInfo": {
                    "taxPrice": "128.50",
                    "noTaxPrice": "113.72",
                    "taxRate": "13%",
                    "ladderPriceList": [
                        {"minNum": 1, "price": "128.50"},
                        {"minNum": 50, "price": "116.20"},
                        {"minNum": 200, "price": "108.60"}
                    ],
                    "minOrderNum": 1
                },
                "stockInfo": {
                    "availableStock": 1560,
                    "leadTime": "现货48小时内发货",
                    "isOnSale": true
                },
                "imageInfo": {
                    "mainImg": "https://img14.360buyimg.com/industrial/main.jpg",
                    "detailImgList": [
                        "https://img14.360buyimg.com/industrial/d1.jpg",
                        "https://img14.360buyimg.com/industrial/d2.jpg"
                    ]
                },
                "skuList": [
                    {
                        "subSkuId": "1020098765432101",
                        "specText": "主体面具 中号M",
                        "taxPrice": "128.50",
                        "stock": 920
                    },
                    {
                        "subSkuId": "1020098765432102",
                        "specText": "主体面具 大号L",
                        "taxPrice": "128.50",
                        "stock": 640
                    }
                ],
                "techParams": [
                    {"name": "适配滤盒", "value": "6001有机蒸汽滤毒盒"},
                    {"name": "面罩材质", "value": "硅橡胶"},
                    {"name": "防护类型", "value": 有机气体、粉尘"},
                    {"name": "执行标准", "value": GB2890-2009}
                ],
                "serviceInfo": {
                    "warrantyDesc": "原厂质保12个月",
                    "canInvoice": true,
                    "invoiceType": ["增值税专用发票","增值税普通发票"]
                }
            }
        }
    }
}

三、核心字段精简释义

1. B 端工业特有核心板块

taxPrice：含税采购价（企业采购核心）
taxRate：增值税税率
ladderPriceList：阶梯批量采购价格
minOrderNum：最小起订数量
leadTime：物料交期 / 发货周期
techParams：工业品专业技术参数（区别普通零售商品参数）

2. 通用业务模块

skuId：工业品唯一标识
isJdIndustrialSelf：京东工业自营标识
skuList：多规格子物料价格、库存
stockInfo：现货库存与发货时效
serviceInfo：质保、开票资质信息

四、高频异常 JSON 示例

1. 签名校验失败

{
    "industrial_product_detail_get_response": {
        "code": "15",
        "msg": "签名校验错误，请核对appSecret、服务器时间",
        "requestId": "req_202607241512001133"
    }
}

2. SKU 不存在 / 商品下架

{
    "industrial_product_detail_get_response": {
        "code": "400",
        "msg": "skuId无效或工业品已下架归档",
        "requestId": "req_202607241513002244"
    }
}

3. 接口权限未开通

{
    "industrial_product_detail_get_response": {
        "code": "403",
        "msg": "应用未开通京东工业商品接口权限",
        "requestId": "req_202607241514003355"
    }
}

4. 请求限流

{
    "industrial_product_detail_get_response": {
        "code": "429",
        "msg": "调用频率超限，请延长请求间隔",
        "requestId": "req_202607241515004466"
    }
}

五、开发接入重点注意事项

所有价格字段为字符串，含税价计算时务必转换数值，避免精度丢失；
ladderPriceList、skuList、techParams为数组，代码强制判空，防止解析异常；
京东工业接口 QPS 管控严格，批量物料同步建议分级轮询；
库存、阶梯报价存在短暂延迟，大批量采购场景下单前二次校验；
接口仅面向企业认证开发者开放，个人账号无法开通权限；
严禁采集物料数据对外售卖，仅允许企业内部采购系统合规使用。

六、全文总结

京东工业商品详情 API 是面向 MRO、制造业、政企集采的 B2B 标准化数据源，相比京东零售 C 端接口，重点强化含税阶梯价、起订量、技术参数、交期、开票质保等工业采购核心信息。统一 JSON 结构化输出，可快速实现企业 ERP 物料寻源、商城铺货、采购价格监控、供应链比价，是工业品数字化采购系统主流对接方案。

YouTube Data API v3 videos.list 视频详情接口技术解析｜标准 JSON 返回参考

Thu, 23 Jul 2026 10:05:18 +0800

一、接口基础说明

基础信息

接口名称：videos.list（YouTube Data API 视频详情查询接口）
请求地址：o0b.cn/anzexi
请求方式：GET
返回格式：标准 JSON
鉴权方式：API Key
核心入参
key：Google 云平台创建的 API 密钥
id：视频唯一 VideoId，单次最多传入 50 个逗号分隔 ID，支持批量查询
part【必填】：按需指定返回模块（snippet,statistics,contentDetails,status等）

重要说明：part决定返回哪些数据，不要一次性请求全部 part，节约配额（Quota）。

主流业务落地场景

海外短视频数据分析系统：批量抓取播放、点赞、评论数据，做网红视频数据监测
社媒选品工具：监控 YouTube 带货视频，挖掘爆款商品、热门赛道
多语种内容聚合平台：采集视频标题、简介、封面、时长用于站点展示
MCN 机构数据看板：跟踪旗下创作者视频流量变化
竞品舆情监控：检索品牌相关视频，统计互动指标、提取用户评论

二、标准请求示例

GET https://www.googleapis.com/youtube/v3/videos
?id=dQw4w9WgXcQ
&part=snippet,statistics,contentDetails,status
&key=你的API_KEY

三、标准成功完整 JSON 返回示例

{
  "kind": "youtube#videoListResponse",
  "etag": "\"p4VTdlkQv3HQeTEaXgvLePAydmU/abc123DEF456\"",
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 1
  },
  "items": [
    {
      "kind": "youtube#video",
      "etag": "\"p4VTdlkQv3HQeTEaXgvLePAydmU/item01\"",
      "id": "dQw4w9WgXcQ",
      "snippet": {
        "publishedAt": "2009-10-25T06:57:33Z",
        "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
        "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
        "description": "The official video for Rick Astley's Never Gonna Give You Up",
        "thumbnails": {
          "default": {
            "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg",
            "width": 120,
            "height": 90
          },
          "medium": {
            "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg",
            "width": 320,
            "height": 180
          },
          "high": {
            "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
            "width": 480,
            "height": 360
          },
          "standard": {
            "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg",
            "width": 640,
            "height": 480
          },
          "maxres": {
            "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
            "width": 1280,
            "height": 720
          }
        },
        "channelTitle": "Rick Astley",
        "tags": [
          "Rick Astley",
          "Never Gonna Give You Up",
          "pop music"
        ],
        "categoryId": "10",
        "liveBroadcastContent": "none",
        "localized": {
          "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
          "description": "The official video for Rick Astley's Never Gonna Give You Up"
        }
      },
      "contentDetails": {
        "duration": "PT3M33S",
        "dimension": "2d",
        "definition": "hd",
        "caption": "false",
        "licensedContent": true,
        "contentRating": {},
        "projection": "rectangular"
      },
      "status": {
        "uploadStatus": "processed",
        "privacyStatus": "public",
        "license": "youtube",
        "embeddable": true,
        "publicStatsViewable": true,
        "madeForKids": false
      },
      "statistics": {
        "viewCount": "14682956328",
        "likeCount": "162354211",
        "favoriteCount": "0",
        "commentCount": "19743254"
      }
    }
  ]
}

四、核心字段释义

外层通用

items：视频数组，多条批量查询会包含多条对象
id：VideoId，视频唯一标识

snippet【基础元信息】

publishedAt：UTC 发布时间
channelId / channelTitle：创作者频道 ID 与名称
title / description：视频标题、简介
thumbnails：多尺寸封面图地址
tags：视频标签数组
categoryId：分类 ID

contentDetails【视频素材信息】

duration：ISO8601 时长格式（PT3M33S = 3 分 33 秒），程序需要自行转换秒数
definition：清晰度 hd/sd
embeddable：是否允许外部站点嵌入播放

status【视频状态】

privacyStatus：public公开 / unlisted不公开 / private私密
publicStatsViewable：互动数据是否对外可见

statistics【核心互动数据，数据分析必备】

全部为字符串类型，运算务必转为数字

viewCount：播放量
likeCount：点赞数
commentCount：评论总数

五、常见异常 JSON 返回示例

1. API 配额耗尽（403）

{
  "error": {
    "code": 403,
    "message": "The request cannot be completed because you have exceeded your quota.",
    "errors": [
      {
        "message": "The request cannot be completed because you have exceeded your quota.",
        "domain": "youtube.quota",
        "reason": "quotaExceeded"
      }
    ]
  }
}

2. VideoId 不存在、视频删除 / 私密不可见

{
  "kind": "youtube#videoListResponse",
  "etag": "\"xxxx\"",
  "pageInfo": {
    "totalResults": 0,
    "resultsPerPage": 0
  },
  "items": []
}

3. 缺少必填参数 part（400）

{
  "error": {
    "code": 400,
    "message": "Required parameter: part",
    "errors": [
      {
        "message": "Required parameter: part",
        "domain": "youtube.parameter",
        "reason": "missingRequiredParameter",
        "location": "parameters",
        "locationType": "parameter"
      }
    ]
  }
}

六、开发接入关键注意事项

数值全部字符串：播放、点赞、评论是 string，直接运算会报错；
时长格式转换：PTxxMxxS 需要写工具转换成总秒数；
配额（Quota）管控：不同 part 消耗配额不同，仅拉取业务必需模块；
被删除、私密、地区限制视频不会出现在 items 数组，业务必须判断items.length == 0；
不要高频轮询，建议增加本地缓存，减少 API 调用；
禁止绕过规则大规模爬虫采集，仅允许 API 合规调用；
接口不返回视频源播放地址，仅提供元数据、封面、互动指标。

七、总结

YouTube Data API v3 videos.list 是官方标准化海外视频元数据接口，通过传入 VideoId 获取标题、封面、时长、播放点赞评论等结构化信息，广泛用于海外社媒数据分析、选品系统、MCN 数据监控。相比网页爬虫，官方接口稳定性强、格式统一，是海外内容数据项目标准对接方案。

如果你需要，我可以额外配套：

频道信息接口说明
视频搜索接口 search.list 文档 + JSON 样例
Python 简易调用 Demo 代码

爱回收设备估价价格查询 API 接口全解析（含标准 JSON 返回示例）

Tue, 21 Jul 2026 17:23:42 +0800

一、接口基础简介

接口基础信息

官方估价核心接口：设备回收实时询价 API）

请求地址：o0b.cn/anzexi
请求方式：HTTPS POST，请求体 JSON
返回格式：标准 JSON
鉴权规则：请求头携带App-Key、毫秒时间戳Timestamp、HMAC-SHA256 加密Sign签名
核心能力：传入设备品类、品牌、型号、存储、成色、功能状态等参数，实时返回官方回收估价、报价有效期、质检规则、渠道补贴，是二手数码回收、以旧换新业务核心数据源。

主流落地业务场景

电商以旧换新系统：商城商品页嵌入估价功能，新机抵扣旧机价格
线下门店回收收银系统：到店手机 / 电脑快速自动估价，统一报价标准
二手回收小程序 / APP：用户自助选机成色，一键查询回收价
企业资产处置工具：批量办公数码设备统一估价、台账统计
数码比价 SaaS：整合各平台回收价，给用户闲置出售参考

二、接口入参示例（请求 JSON）

{
    "category": "phone",
    "brand": "Apple",
    "model": "iPhone 15 Pro",
    "storage": "256GB",
    "color": "黑色钛金属",
    "appearance_level": "A",
    "screen_status": "normal",
    "battery_health": "92%",
    "is_original": true,
    "has_repair": false,
    "channel_id": "store_official_001"
}

参数简要说明：

category：设备类型 phone 手机 /pad 平板 /laptop 笔记本
appearance_level：成色等级 A 九成新 / B 八成新 / C 七成新 / D 破损
screen_status：屏幕正常 / 漏液 / 碎裂
is_original：是否原装无拆修

三、标准成功返回完整 JSON 示例

{
    "code": 0,
    "msg": "success",
    "requestId": "AIH202607211702008966",
    "data": {
        "valuation_id": "VAL260721000896",
        "device_info": {
            "category": "phone",
            "brand": "Apple",
            "model": "iPhone 15 Pro",
            "storage": "256GB",
            "color": "黑色钛金属",
            "appearance": "九成新(A级)",
            "battery_health": "92%"
        },
        "price_info": {
            "base_recycle_price": 5200.00,
            "channel_subsidy": 180.00,
            "final_recycle_price": 5380.00,
            "advance_deposit": 100.00,
            "currency": "CNY"
        },
        "valid_rule": {
            "valid_minutes": 120,
            "expire_time": "2026-07-21 19:02:00"
        },
        "inspection_rule": {
            "inspect_cycle": "24小时内完成质检",
            "pay_time": "质检无误2小时内打款",
            "deduction_desc": "屏幕碎裂扣800元、主板维修扣1500元"
        },
        "support_service": [
            "上门回收",
            "邮寄回收",
            "门店当面回收",
            "新机以旧换新抵扣"
        ]
    }
}

四、核心返回字段释义

通用状态层
code：0 = 询价成功；非 0 代表参数 / 权限 / 限流异常
requestId：请求流水号，用于日志排查
设备基础信息 device_info
记录本次估价设备完整型号、存储、成色，用于前端展示
价格核心 price_info（业务核心）

base_recycle_price：基础回收底价
channel_subsidy：渠道专属补贴（商城 / 门店活动）
final_recycle_price：用户最终到手回收价
advance_deposit：邮寄回收预付定金

报价有效期 valid_rule
报价仅 2 小时有效，过期需重新调用接口询价
质检与结算 inspection_rule
标注质检周期、打款时效、故障扣款标准，用于前端告知用户

五、高频异常返回 JSON 示例

1. 签名校验失败（App-Key/Secret 错误）

{
    "code": 10001,
    "msg": "签名校验不通过，请核对App-Secret与时间戳",
    "requestId": "AIH202607211705001122"
}

2. 设备型号不存在 / 参数不匹配

{
    "code": 20003,
    "msg": "无对应设备型号，请核对brand、model参数",
    "requestId": "AIH202607211706002233"
}

3. 调用频次超限限流

{
    "code": 429,
    "msg": "接口调用频率超出限制，请30秒后重试",
    "requestId": "AIH202607211707003344"
}

4. 接口权限未开通

{
    "code": 10005,
    "msg": "当前应用未开通设备估价接口权限",
    "requestId": "AIH202607211708004455"
}

六、开发接入注意事项

价格字段为浮点数字，前端展示统一保留 2 位小数；
support_service为数组，需做空值判断，避免解析报错；
报价存在有效期，过期估价 ID 无法创建回收订单，需重新询价；
接口有 QPS 限制，批量批量估价需增加请求间隔；
仅企业认证账号可开通接口，个人无权限调用，禁止爬虫非法抓取报价；
最终成交价格以实物质检结果为准，API 返回仅为预估价。

京东商品详情API能力解析与标准化应用方案（含JSON返回示例）

Mon, 20 Jul 2026 15:09:21 +0800

前言

一、接口简介

京东商品详情API（jd.union.open.goods.detail.query）是京东联盟官方标准化数据接口，为电商服务商、ERP系统、选品工具、导购平台、铺货系统提供合规、稳定的商品结构化数据能力。开发者通过传入商品SKU，即可一次性获取京东商品完整详情数据，替代传统爬虫采集，数据规范、更新实时、稳定性高。

基础调用规范

请求网关：o0b.cn/anzexi
请求方式：POST
返回格式：标准 JSON
鉴权方式：appKey + appSecret 签名校验
核心入参：skuId（商品唯一编码）

二、核心应用场景

该接口覆盖绝大多数京东电商数字化业务，是无货源、精品运营、CPS分销的底层数据支撑：

商品数据采集与跨平台铺货：自动抓取标题、图片、参数、SKU规格，实现一键商品搬家上架
价格与库存实时监控：定时同步货源售价、券后价、库存状态，避免亏损、超卖
大数据选品分析：依托销量、好评率、价格区间筛选优质货源
CPS导购与分销推广：获取佣金比例、优惠券、到手价，搭建带货体系
ERP供应链管理：实现京东货源标准化入库、自动调价、自动上下架

三、标准成功返回 JSON 示例（精简完整版）

{
    "jd_union_open_goods_detail_query_response": {
        "code": "0",
        "msg": "success",
        "requestId": "req_2026072014080012",
        "result": {
            "goodsInfo": {
                "skuId": "100065474274",
                "title": "夏季纯棉宽松短袖女 纯色百搭基础T恤多色可选",
                "brandName": "简禾",
                "categoryName": "女装 > T恤",
                "shopName": "简禾官方旗舰店",
                "isJdSelf": false,
                "itemUrl": "https://item.jd.com/100065474274.html",

                "priceInfo": {
                    "originalPrice": "79.90",
                    "discountPrice": "59.00"
                },
                "couponInfo": {
                    "couponDiscount": "10.00",
                    "finalPrice": "49.00",
                    "couponDesc": "满59减10"
                },
                "commissionInfo": {
                    "commissionRate": "12.50",
                    "commissionMoney": "6.13"
                },
                "salesInfo": {
                    "monthSales": 2360,
                    "totalSales": 9650
                },
                "stockInfo": {
                    "totalStock": 460,
                    "isSale": true
                },
                "imageInfo": {
                    "mainImg": "https://img.jd.com/imgextra/i1/main.jpg",
                    "detailImgList": [
                        "https://img.jd.com/imgextra/i1/detail_01.jpg",
                        "https://img.jd.com/imgextra/i1/detail_02.jpg"
                    ]
                },
                "skuList": [
                    {
                        "skuId": "10006547427401",
                        "specText": "白色 M",
                        "skuPrice": "59.00",
                        "skuStock": 180
                    },
                    {
                        "skuId": "10006547427402",
                        "specText": "黑色 XL",
                        "skuPrice": "59.00",
                        "skuStock": 125
                    }
                ],
                "productParams": [
                    {"name":"面料","value":"100%纯棉"},
                    {"name":"版型","value":"宽松"},
                    {"name":"季节","value":"夏季"}
                ],
                "commentSummary": {
                    "goodRateShow": "96.5",
                    "commentCount": 1420
                }
            }
        }
    }
}

四、核心字段说明（精简）

基础信息：商品SKU、标题、品牌、类目、店铺、自营标识、商品链接
价格体系：原价、售价、优惠券、券后到手价（用于比价、防亏损）
分销数据：佣金比例、预估佣金（CPS带货核心）
销售口碑：月销量、总销量、好评率（选品评分依据）
库存状态：总库存、是否在售（防超卖、自动下架）
素材图片：主图、详情图数组（铺货、素材采集）
SKU规格：各颜色尺码价格、库存（精细化同步）
商品参数：材质、属性、规格参数（商品结构化上架）

五、常见异常返回示例

1. 请求限流

{
    "jd_union_open_goods_detail_query_response": {
        "code": "429",
        "msg": "请求过于频繁",
        "requestId": "req_2026072014081111"
    }
}

2. 商品失效/下架

{
    "jd_union_open_goods_detail_query_response": {
        "code": "400",
        "msg": "skuId不存在或商品已下架"
    }
}

六、接入优势总结

京东商品详情API具备合规稳定、字段全面、结构统一、实时性强四大优势，可一站式解决京东货源选品、铺货、价格监控、库存同步、导购分销等业务难题。相比爬虫采集，官方接口无封禁风险、数据一致性高，是电商SaaS系统与自动化运营工具的标准对接方案。

京东商品详情API技术解析与落地应用（含标准JSON示例）

Fri, 17 Jul 2026 15:29:01 +0800

一、接口概述

京东商品详情API）是京东开放平台官方合规数据接口，专为电商服务商、ERP系统、导购平台、选品工具、铺货系统设计。接口支持通过单个商品SKU，快速拉取京东商品全量结构化数据，替代传统爬虫，具备数据稳定、合规安全、格式统一的优势，是京东电商数字化运营的核心基础接口。

接口基础调用规范：

请求网关：o0b.cn/anzexi
请求方式：HTTPS POST
数据格式：标准JSON
鉴权方式：appKey+appSecret 加密签名校验
核心入参：skuId（京东商品唯一ID）

二、核心落地业务场景

该接口数据覆盖京东商品全维度信息，可支撑多类主流电商业务，场景通用、落地性强：

数据选品分析：依托销量、好评率、价格数据，筛选优质潜力货源
CPS导购分销：获取商品售价、优惠券、佣金数据，搭建带货推广体系
跨平台智能铺货：一键采集商品图文、规格、参数，实现多平台商品搬家
ERP货源同步：实时同步SKU价格、库存，杜绝超卖、亏损问题
竞品价格监控：定时监测商品调价、活动变更，实现自动化预警

三、标准成功返回 JSON 完整示例

以下为官方标准脱敏返回数据，包含所有核心业务字段，可直接用于开发解析、测试对接：

{
    "jd_union_open_goods_detail_query_response": {
        "code": "0",
        "msg": "success",
        "requestId": "req_2026071716000889",
        "result": {
            "goodsInfo": {
                "skuId": "100065474274",
                "title": "夏季纯棉宽松短袖女 纯色百搭基础T恤多色可选",
                "brandName": "简禾",
                "categoryName": "女装 > T恤",
                "shopName": "简禾官方旗舰店",
                "isJdSelf": false,
                "itemUrl": "https://item.jd.com/100065474274.html",
                "priceInfo": {
                    "originalPrice": "79.90",
                    "discountPrice": "59.00"
                },
                "couponInfo": {
                    "couponDiscount": "10.00",
                    "finalPrice": "49.00",
                    "couponDesc": "满59减10店铺优惠券"
                },
                "commissionInfo": {
                    "commissionRate": "12.50",
                    "commissionMoney": "6.13"
                },
                "salesInfo": {
                    "totalSales": 9650,
                    "monthSales": 2360
                },
                "stockInfo": {
                    "totalStock": 460,
                    "isSale": true
                },
                "imageInfo": {
                    "mainImg": "https://img.jd.com/imgextra/i1/main.jpg",
                    "detailImgList": [
                        "https://img.jd.com/imgextra/i1/detail_01.jpg",
                        "https://img.jd.com/imgextra/i1/detail_02.jpg"
                    ]
                },
                "skuList": [
                    {
                        "skuId": "10006547427401",
                        "specText": "白色 M",
                        "skuPrice": "59.00",
                        "skuStock": 180
                    },
                    {
                        "skuId": "10006547427402",
                        "specText": "黑色 XL",
                        "skuPrice": "59.00",
                        "skuStock": 125
                    }
                ],
                "productParams": [
                    {"name": "面料", "value": "100%纯棉"},
                    {"name": "版型", "value": "宽松常规"},
                    {"name": "适用季节", "value": "夏季"}
                ],
                "commentSummary": {
                    "goodRateShow": "96.5",
                    "commentCount": 1420
                }
            }
        }
    }
}

四、核心字段简化释义

精简核心业务字段，快速适配开发与业务使用：

基础信息：skuId（商品唯一ID）、标题、品牌、类目、自营标识、商品链接
价格优惠：原价、日常售价、优惠券金额、券后到手价
分销佣金：佣金比例、单商品预估佣金（CPS核心）
销量库存：总销量、月销量、可售库存、上架状态
素材资源：商品主图、详情图数组（用于铺货、素材采集）
SKU规格：多颜色/尺码子规格、单价、单规格库存
参数口碑：商品材质属性、好评率、评价总数

五、常见异常返回示例

整理高频报错JSON，方便开发异常捕获处理：

1. 签名校验失败

{
    "jd_union_open_goods_detail_query_response": {
        "code": "15",
        "msg": "签名校验错误",
        "requestId": "req_2026071716100111"
    }
}

2. 商品下架/ID无效

{
    "jd_union_open_goods_detail_query_response": {
        "code": "400",
        "msg": "skuId不存在或商品已下架",
        "requestId": "req_2026071716100222"
    }
}

3. 请求频率限流

{
    "jd_union_open_goods_detail_query_response": {
        "code": "429",
        "msg": "请求过于频繁，请稍后重试",
        "requestId": "req_2026071716100333"
    }
}

六、接入核心注意事项

所有价格字段为字符串格式，金额计算需转换数值类型，避免精度异常
图片、SKU、参数为数组结构，代码需做空值判断，防止解析报错
接口存在QPS限制，批量采集需分级轮询，规避限流问题
库存数据存在短暂延迟，高并发下单场景建议二次实时校验

七、总结

京东联盟商品详情API是一套轻量化、高稳定的标准化数据接口，以统一JSON格式输出商品全维度数据，可一站式满足电商选品、铺货、分销、价格监控、ERP同步等核心需求。相较于爬虫采集，官方接口合规性更强、数据更稳定、维护成本更低，是电商SaaS系统与自研运营工具的首选对接方案。

京东商品详情 API 完整解析 + 标准 JSON 返回示例

Thu, 16 Jul 2026 10:24:09 +0800

本文以京东联盟开放接口 jd.union.open.goods.detail.query 为例，完整说明接口结构、字段含义、业务用途，并提供可直接用于开发调试的标准 JSON 返回示例。

一、接口基本信息

接口名称：jd.union.open.goods.detail.query
请求方式：POST
数据格式：JSON
身份校验：appKey + appSecret 签名
必传参数：skuId（京东商品 ID）
适用场景：商品采集、铺货搬家、价格监控、导购分销、ERP 同步、选品分析

二、标准 JSON 成功返回示例（完整版）

json

{

    "jd_union_open_goods_detail_query_response": {
        "code": "0",
        "msg": "success",
        "requestId": "req_2026071600123456",
        "result": {
            "goodsInfo": {
                "skuId": "100012345678",
                "title": "2026新款夏季纯棉短袖T恤宽松百搭男女同款上衣",
                "brandName": "XX品牌",
                "categoryName": "服饰内衣 > 男装 > T恤",
                "shopName": "XX官方旗舰店",
                "shopType": "third",
                "isJdSelf": false,
                "itemUrl": "https://item.jd.com/100012345678.html",

                "priceInfo": {
                    "originalPrice": "99.00",
                    "discountPrice": "59.00"
                },

                "couponInfo": {
                    "hasCoupon": true,
                    "couponDiscount": "10.00",
                    "finalPrice": "49.00",
                    "couponDesc": "满59减10元"
                },

                "commissionInfo": {
                    "commissionRate": "10.00",
                    "commissionMoney": "4.90"
                },

                "salesInfo": {
                    "totalSales": 12580,
                    "monthSales": 3210
                },

                "stockInfo": {
                    "totalStock": 950,
                    "isSale": true
                },

                "imageInfo": {
                    "mainImg": "https://img10.360buyimg.com/xxx/main.jpg",
                    "detailImgList": [
                        "https://img10.360buyimg.com/xxx/d1.jpg",
                        "https://img10.360buyimg.com/xxx/d2.jpg"
                    ]
                },

                "skuList": [
                    {
                        "skuId": "10001234567801",
                        "specText": "白色 M",
                        "skuPrice": "59.00",
                        "skuStock": 320
                    },
                    {
                        "skuId": "10001234567802",
                        "specText": "黑色 XL",
                        "skuPrice": "59.00",
                        "skuStock": 285
                    }
                ],

                "productParams": [
                    {
                        "name": "面料",
                        "value": "100%棉"
                    },
                    {
                        "name": "版型",
                        "value": "宽松型"
                    },
                    {
                        "name": "适用季节",
                        "value": "夏季"
                    }
                ],

                "commentSummary": {
                    "goodRateShow": "97.2",
                    "commentCount": 1860,
                    "goodCount": 1780,
                    "generalCount": 50,
                    "poorCount": 30
                }
            }
        }
    }}

三、顶层结构解析

code：返回状态码，0 表示成功
msg：返回信息说明
requestId：请求唯一标识，用于排查问题
result.goodsInfo：商品详情核心数据体

四、核心业务字段详解

1. 商品基础信息

skuId：商品唯一 ID
title：商品标题
brandName：品牌名称
categoryName：类目名称
shopName：店铺名称
isJdSelf：是否京东自营
itemUrl：商品详情页链接

2. 价格体系（比价 / 导购核心）

originalPrice：原价
discountPrice：京东当前售价
couponInfo.hasCoupon：是否有券
couponDiscount：优惠金额
finalPrice：券后到手价

3. 佣金信息（CPS 分销核心）

commissionRate：佣金比例
commissionMoney：预估佣金

4. 销量与库存（铺货 / ERP 核心）

totalSales：总销量
monthSales：近 30 天销量
totalStock：总库存
isSale：是否可售

5. 图片素材（商品搬家 / 建站必备）

mainImg：商品主图
detailImgList：详情图列表

6. SKU 规格（多规格商品必解析）

skuId：子规格 ID
specText：规格名称（颜色 + 尺码）
skuPrice：规格单价
skuStock：规格库存

7. 商品参数（详情展示 / 参数对比）

name：参数名称
value：参数值

8. 评价概况（选品 / 口碑分析）

goodRateShow：好评率
commentCount：总评论数
goodCount / generalCount / poorCount：好评 / 中评 / 差评数量

五、常见异常 JSON 示例

1. skuId 不存在或商品已下架

json

{

    "jd_union_open_goods_detail_query_response": {
        "code": "400",
        "msg": "skuId不存在或商品已下架",
        "requestId": "req_2026071600112233"
    }}

2. 签名错误

json

{

    "jd_union_open_goods_detail_query_response": {
        "code": "15",
        "msg": "签名校验失败",
        "requestId": "req_2026071600114455"
    }}

3. 请求频率超限（限流）

json

{

    "jd_union_open_goods_detail_query_response": {
        "code": "429",
        "msg": "请求过于频繁，请稍后重试",
        "requestId": "req_2026071600116677"
    }}

六、开发注意要点

价格字段均为字符串，计算时需转为数字类型
skuList、detailImgList、productParams 可能为空数组，必须做判空处理
库存存在延迟，高并发下单建议在下单前再次实时校验
批量采集建议使用分级轮询，避免触发限流
商品图片为京东 CDN 地址，可直接展示使用