淘宝电商已实测接口
默认接入清单只推荐已有真实业务成功证据的方法:15 个已实测查询、1 个已实测修改,共 6 个接口分组。
实测只证明测试时的已授权店铺与业务场景成功,其他店铺仍需满足淘宝权限、授权和商家资格。HTTP 200、签名签发、缺少参数或无效目标探测均不算业务成功;未验证和明确拒绝的方法不进入默认接口选择。
已实测查询与修改
每条记录保留实测类型、时间与说明。成功查询不证明同组修改接口可用;某店铺成功也不代表所有店铺均具备相同资格。
| 接口 | 完整方法名 | 实测状态 | 说明 |
|---|---|---|---|
| 获取前台展示的店铺类目 ↗ | 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。参数错误保持未验证,明确拒绝单独记录,不能把所有业务错误都解释为权限不足。写操作会真实生效,结果未知时先查实际状态,不自动重试或换路执行。