拼多多开放平台 · API 参考与接入状态

📌 接口概述 pdd.erp.order.sync

pdd.erp.order.sync 用于把 ERP 系统中的订单物流 / 运单信息回传到拼多多打单系统， 以实现自动打印快递单、发票及订单状态跟踪。这是一个商家后台写接口（数据往外推）， 不返回商品列表，无法用于「商品推荐 / 猜你喜欢」场景。

🧪 接口可用性实测结论 2026-09-22 · 直连网关验证

以下结果由本站服务端持 client_id + client_secret 直连 gw-api.pinduoduo.com 实测取得（非文档推测）。判读要点：21002 表示 已过鉴权（只缺参数）；20031 表示接口存在但无权限包； 50001 非多多客 表示需绑定多多进宝 duoId；10017 表示接口名不存在。

🚧 当前阻塞点 · 多多进宝提示「clientID不存在，无法绑定」 2026-09-22 实测

在 jinbao.pinduoduo.com/third-party/rank（多多客 API 工具 → 绑定 Client ID）输入本站 client_id 时，页面顶部提示 「clientID不存在，无法绑定」。 结合网关实测（密钥有效、三个基础接口成功、ddk 族全部 50001、商家族全部 20031）， 可判定：问题不在密钥与签名，而在应用资质与账号归属——网关承认这个应用，但多多进宝不认它。

按概率依次排查

🚀 启用商品橱窗的三条路径

路径 A · 多多客（推荐，免费、无需用户授权）

• 确认开放平台登录手机号与多多进宝一致（不一致就先统一，这是硬前提）；
• 在该账号下创建应用（多多客 / 工具商类型更贴合），提交并等待审核通过；
• 到 jinbao.pinduoduo.com/third-party/rank 用新应用的 client_id 完成 duoId 绑定；
• 在多多进宝创建推广位得到 pid（形如 1234567_12345678_123456789）；
• 把新的 client_id / client_secret / pid 写入服务器 .pdd_config.json； 无需改代码、无需重启，首页右栏自动切回商品橱窗。

路径 B · 商家自营商品（需权限包 + OAuth 授权）

• 在开放平台为应用申请商品管理 / 商品查询类权限包，使 pdd.goods.list.get 走出 20031；
• 完成店铺 OAuth 授权换取 access_token（pdd.pop.auth.token.create 需要一次性 code）；
• 把 access_token 写入 .pdd_config.json，生效接口 pdd.goods.list.get（仅本店商品）。

路径 C · 零依赖（当前已上线）

• 首页右栏在拼多多通道不可用时，自动降级为「🆕 站内上新」（按作品真实时间倒序，1542 件展品中 574 件有真实时间戳）；
• 访客侧不会看到任何错误码或绑定指引，技术原因收进页面上的「ⓘ 查看原因」折叠区；
• 优势：无需任何外部账号资质，首页永远有内容；拼多多通道打通后自动切换为商品橱窗。

🌐 请求地址

注：拼多多开放平台目前无沙箱环境，仅提供正式环境。

🔧 公共参数（每次调用必带）

📦 业务参数 pdd.erp.order.sync

🔏 签名算法（MD5 · 大写）

步骤

• 收集所有业务参数 + 公共参数（除 sign 外），剔除值为空的参数；
• 按参数名 ASCII 升序排序；
• 拼接为 key1value1key2value2…（无分隔符）；
• 首尾各拼接 client_secret：secret + 拼接串 + secret；
• 对结果做 MD5，得到 32 位签名，并转为大写后作为 sign 传入。

Node.js 示例

// 服务端代理示例（与本站 /api/pdd/guess 同款逻辑）
const crypto = require('crypto');
function pddSign(params, secret) {
  const keys = Object.keys(params)
    .filter(k => params[k] !== '' && k !== 'sign')
    .sort();
  let s = secret;
  for (const k of keys) s += k + params[k];
  s += secret;
  return crypto.createHash('md5').update(s).digest('hex').toUpperCase(); // 必须大写
}

Python 示例

import hashlib
def pdd_sign(params, secret):
    items = sorted((k, v) for k, v in params.items()
                   if k != 'sign' and v != '')
    raw = secret + ''.join(f'{k}{v}' for k, v in items) + secret
    return hashlib.md5(raw.encode('utf-8')).hexdigest().upper()   # 必须大写

🧾 常见错误码速查

📨 返回结构（示例）

{
  "error_response": {            // 仅出错时存在
    "error_code": 50001,
    "error_msg": "非多多客，请到 ... 检查：1. duoId是否绑定clientId ...",
    "request_id": "179..."
  },
  "goods_search_response": {     // 成功时为具体业务的 _response 节点
    "goods_list": [ { "goods_id", "goods_name", "min_group_price", "goods_thumbnail_url", "sales_tip", "goods_sign" } ]
  }
}

调用示例（简化）

const params = {
  type: 'pdd.erp.order.sync',
  client_id, timestamp: String(Math.floor(Date.now()/1000)),
  data_type: 'JSON',
  logistics_id: '1001', order_sn: '2609...',
  order_state: '1', waybill_no: 'YT1234567890'
};
params.sign = pddSign(params, client_secret);   // MD5 大写
// POST application/x-www-form-urlencoded 到网关地址

🔗 本站接入状态

• ✓ 本参考页部署于 /pdd-api.html（展览馆站）。
• ✓ 首页橱窗代理 /api/pdd/guess 已上线，按 pdd.ddk.goods.recommend.get → pdd.ddk.goods.search 顺序尝试，失败自动回退。
• ✓ 密钥自检接口 /api/pdd/status 已上线，实时校验密钥与签名。
• ✓ client_id / client_secret 已注入服务器 .pdd_config.json（权限 600）；隐藏文件已被静态通道拦截，公网访问返回 404。
• ✓ 首页「猜你喜欢的」右栏已实现优雅降级：拼多多通道不可用时呈现「🆕 站内上新」， 访客侧不出现错误码；技术原因收进「ⓘ 查看原因」折叠区。
• … 待办：完成开放平台 / 多多进宝账号资质与 duoId 绑定（或申请商品权限包）后， 橱窗自动出商品卡，无需改代码、无需重启。