奇门云API 服务台
TAOBAO COMMERCE API

淘宝电商已实测接口

默认接入清单只推荐已有真实业务成功证据的方法:15 个已实测查询、1 个已实测修改,共 6 个接口分组。

实测只证明测试时的已授权店铺与业务场景成功,其他店铺仍需满足淘宝权限、授权和商家资格。HTTP 200、签名签发、缺少参数或无效目标探测均不算业务成功;未验证和明确拒绝的方法不进入默认接口选择。

测试已实测接口下载已实测接口目录全部核实状态 ↓AI 接入说明 ↗

已实测查询与修改

每条记录保留实测类型、时间与说明。成功查询不证明同组修改接口可用;某店铺成功也不代表所有店铺均具备相同资格。

接口完整方法名实测状态说明
获取前台展示的店铺类目 ↗taobao.shopcats.list.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:46:41)
获取图片分类信息 ↗taobao.picture.category.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:49:58)
获取图片信息 ↗taobao.picture.get已实测查询普通图片空间查询已成功;后续按商品图片URL过滤返回533 / PICTURE_PARAMETER_ERROR,该过滤方式尚未验证可用。(北京时间 2026/10/16 14:49:58)
查询图片空间用户的信息 ↗taobao.picture.userinfo.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:49:58)
图片是否被引用 ↗taobao.picture.isreferenced.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:49:58)
图片获取 ↗taobao.picture.pictures.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:49:58)
图片总数查询 ↗taobao.picture.pictures.count已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:49:58)
根据商品ID列表获取SKU信息 ↗taobao.item.skus.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 16:12:42)
获取SKU ↗taobao.item.sku.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 15:35:40)
获取当前会话用户出售中的商品列表 ↗taobao.items.onsale.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:51:13)
得到当前会话用户库存中的商品列表 ↗taobao.items.inventory.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:46:41)
获取单个商品详细信息 ↗taobao.item.seller.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 16:12:42)
天猫商品/SKU商家编码更新接口 ↗tmall.item.outerid.update已实测修改仅验证单个SKU商家编码修改:新值读回成功、原值恢复后读回成功,9项价格/库存/属性及商品状态校验通过;不代表SKU展示名或详情编辑可用。(北京时间 2026/10/16 15:35:40)
获取天猫商品尺码表模板列表 ↗tmall.item.sizemapping.templates.list已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 14:46:41)
获取商品已生效营销活动更新规则 ↗taobao.item.promotion.rule.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 15:14:54)
查询卖家用户信息 ↗taobao.user.seller.get已实测查询官方TOP只读业务调用成功;仅代表已测试授权店铺和参数。(北京时间 2026/10/16 16:12:42)

签名直连与店铺授权

先从已实测目录选择具体方法,打开该条目的淘宝官方 docUrl,核对字段、类型和适用条件。向 POST /api/taobao/sign 申请签名,再由你的服务器执行官方请求并接收数据。沿用有效万相台服务、同一淘宝应用的已授权店铺和客户密钥。

在服务台“AI 对接包”生成专属配置,或下载 Python 签名客户端。客户密钥只发给奇门云;app_key、session、sign 由服务端生成,不放入业务 params。

POST https://api.miandanni.com/api/taobao/sign
Authorization: Bearer 你的奇门云客户密钥
Content-Type: application/json

{"shopKey":"自己的已授权店铺","method":"从已实测目录选择的完整方法名","params":{}}

签发成功只代表生成了签名,客户端仍需执行 data.request 并检查淘宝业务结果。网页内测试由奇门云服务器执行;程序对接使用签名直连。查看签名合同与凭证说明 →

参数、图片与返回结果

电商 params 的 UTF-8 JSON 上限为 2 MiB,签名外层 JSON 上限为 3 MiB。XML/schema 保留原始文本;商品、SKU、用户等长 ID 请预先使用字符串。目录列出 location.state 等点分根字段时,以完整字面键传入,不改成嵌套对象。普通数组可按官方要求使用 CSV 或列表,复杂对象依对应方法填写。

图片申请签名只传 files 字段与文件名,SDK 使用本地路径将原始字节 multipart 直传淘宝。BMP 支持以具体接口的格式限制为准;可选图片未选时不虚构文件路径。图片上传成功本身不证明商品详情已更新。

HTTP 200 仍需检查 error_response、top_result.info.ok、逐项失败和 request_id。参数错误保持未验证,明确拒绝单独记录,不能把所有业务错误都解释为权限不足。写操作会真实生效,结果未知时先查实际状态,不自动重试或换路执行。