商品与图片等电商业务请先查看 淘宝电商已实测接口 →。仅目录中明确列为已实测的方法供优先对接;服务订购和店铺授权不代表所有电商方法均可调用。

万相台 API · 本站接口文档

授权自己的店铺,接入广告查询与投放管理。

客户购买的奇门云密钥用于接入本站网关;实际调用的是淘宝开放平台万相台官方 API。完整 method、业务参数名称、类型、嵌套结构、金额单位和适用推广场景以淘宝官方文档为准。本站负责客户鉴权、店铺归属校验、授权凭据管理和签名。程序对接使用签名直连。老客户原程序继续可用。

文档核对日期:2026-09-19。业务字段、类型和嵌套层级按淘宝官方文档整理;本站请求地址、Bearer 密钥鉴权和 shopKey 店铺标识采用下方接入规则。淘宝后续变更请同时对照官方原文。

进入万相台服务台 →

新接入:签名直连

先向 POST /api/wanxiang/sign 提交自己的客户密钥、shopKey、完整 method 和 params,奇门云验证后返回官方请求,由你的服务器直接请求淘宝并接收数据。查询、修改、创建和删除均使用相同流程。

到服务台生成默认直连的 AI 对接包即可取得客户端和店铺配置。我们的 AppSecret 与刷新凭证不提供给客户;当次官方请求包含你自己店铺的访问凭据,应仅保存在服务器。写请求超时后先查实际状态,不能自动重试或切换转发。

签名合同与 Python 客户端 →

网页内测试由服务端执行;程序对接使用签名直连。

付费密钥接入,业务接口遵循淘宝官方文档

开发时请将淘宝官方方法名填入 method,将官方业务参数填入 params;先向本站签名入口申请签名,使用 Authorization: Bearer 奇门云密钥,并填写已授权店铺的 shopKey。

奇门云密钥不是淘宝 AppSecret 或 access_token。不要把它填入淘宝 SDK 的 app_secret,也不要用它计算淘宝签名。官方示例中的公共鉴权参数由服务器处理,客户只提交业务参数。

本站目录是官方接口的接入索引与整理说明。每周一北京时间凌晨 2:00 检查官方更新,经核对和验证后同步上线;这不是实时同步。若官方已更新而本站仍返回 WANXIANG_METHOD_NOT_ALLOWED,请提供完整方法名和官方文档链接联系我们同步,不代表淘宝拒绝了你的权限。

接口是否可在当前店铺和推广场景使用,以淘宝实际校验结果为准。购买本站服务不自动授予淘宝平台权限。

先完成这三步

  1. 注册并登录奇门云,选择“万相台 API”,点击“授权淘宝店铺”。登录你自己的淘宝卖家账号,按淘宝页面提示确认授权。
  2. 购买万相台套餐。万相台与奇门套餐独立计时:月付 1,000 元、年付 8,000 元、5 年 25,000 元。提交订单后,可联系管理员协商改价,确认金额后付款。
  3. 在“店铺授权与密钥”中复制奇门云密钥和店铺 shopKey,到“接口测试”运行查询或复制 Python 示例。

店铺必须具备对应的淘宝应用订购和接口权限;购买本网站套餐不会替代淘宝平台的应用订购、店铺授权或广告账户开通。实际可查询数据以平台返回为准。

签名申请格式

POST https://api.miandanni.com/api/wanxiang/sign

请求头:Authorization: Bearer 你的奇门云密钥,Content-Type: application/json。

字段填写内容
shopKey服务台显示的已授权店铺标识,保持字符串;只能调用当前账户自己的有效店铺。
method淘宝官方文档中的完整方法名,可通过下方目录查找对应官方链接。
params该方法的业务参数 JSON 对象。对象和数组可直接传递,无需自行签名。

同一账户可复用奇门云密钥,但每次请求分别检查万相台服务到期时间与店铺归属。此接口使用 shopKey,不使用旺店通 SID 或 bindingId。不要在参数中填写真实 AppSecret、Token 或 sign。

Python 签名直连示例

先下载 qimenyun_direct.py 签名客户端,与下面的业务脚本放在同一目录。先查询可用推广场景,再按需要开发计划或报表,密钥在运行时输入。

# Python 3.9+,无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名,再由本程序直接请求淘宝;业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥:").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写自己的 shopKey\",\"method\":\"taobao.universalbp.new.account.get.can.use.bizcode\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey:").strip()

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时,先查询实际状态。

网页接口测试可根据所选店铺、方法和参数生成相应的简单 Python 代码。

万相台接口目录

点击“本站详情”查看该接口的业务参数、字段层级、返回结构和本站调用说明,也可打开同一接口的淘宝官方文档对照。支持目录中的全部已授权方法,包括查询和修改操作;目录包含专用或有限开放接口,不代表当前应用和店铺已获相应权限。

匹配 136 / 136 个接口。目录列出接入范围,实际调用还需应用和店铺获得相应授权。

广告账户(account) 3 个接口
用途类型method本站接口文档淘宝官方文档
获取账户可用的bizCode查询taobao.universalbp.new.account.get.can.use.bizcode本站详情 →官方文档 ↗
获取账户余额,现金余额查询taobao.universalbp.new.account.get.balance本站详情 →官方文档 ↗
判断用户是否迁移新bp查询taobao.universalbp.new.account.is.universal.user本站详情 →官方文档 ↗
推广素材(material) 5 个接口
用途类型method本站接口文档淘宝官方文档
获取店铺信息查询taobao.universalbp.new.material.shop.get本站详情 →官方文档 ↗
预览算法优选的商品信息查询taobao.universalbp.new.material.intelligentpreshow本站详情 →官方文档 ↗
分页查询商品信息查询taobao.universalbp.new.material.item.findpage本站详情 →官方文档 ↗
物料准入判断查询taobao.universalbp.new.material.accessallowed本站详情 →官方文档 ↗
分页查询看点信息查询taobao.universalbp.new.material.find.spot本站详情 →官方文档 ↗
推广计划(campaign) 20 个接口
用途类型method本站接口文档淘宝官方文档
查询计划分页列表查询taobao.universalbp.new.campaign.findpage本站详情 →官方文档 ↗
高级设置更改计划修改taobao.universalbp.new.campaign.advanced.batchupdate本站详情 →官方文档 ↗
更新计划基础属性修改taobao.universalbp.new.campaign.updatepart本站详情 →官方文档 ↗
更新计划所属计划组修改taobao.universalbp.new.campaign.updategroup本站详情 →官方文档 ↗
查询单个计划详情查询taobao.universalbp.new.campaign.get本站详情 →官方文档 ↗
查询全量计划列表(不分页)查询taobao.universalbp.new.campaign.findlist本站详情 →官方文档 ↗
删除计划修改taobao.universalbp.new.campaign.delete本站详情 →官方文档 ↗
批量更新计划预算修改taobao.universalbp.new.campaign.budget.batchupdate本站详情 →官方文档 ↗
批量更新计划出价修改taobao.universalbp.new.campaign.bid.batchupdate本站详情 →官方文档 ↗
查询无界版计划对应的原场景计划id查询taobao.universalbp.new.campaign.findsubcampaignid本站详情 →官方文档 ↗
计划互斥判断查询taobao.universalbp.new.campaign.site.itemdiff本站详情 →官方文档 ↗
批量更新计划卡位方式修改taobao.universalbp.new.campaign.updatedetent本站详情 →官方文档 ↗
一键恢复修改taobao.universalbp.new.campaign.onerecover本站详情 →官方文档 ↗
一键暂停修改taobao.universalbp.new.campaign.oneclick本站详情 →官方文档 ↗
冻结单划拨修改taobao.universalbp.new.campaign.freeze本站详情 →官方文档 ↗
手动结束计划(慎用)修改taobao.universalbp.new.campaign.finish本站详情 →官方文档 ↗
批量更新计划出价修改taobao.universalbp.new.campaign.onebpsearch.batchupdate本站详情 →官方文档 ↗
批量更新计划出价修改taobao.universalbp.new.campaign.onebpsite.batchupdate本站详情 →官方文档 ↗
批量更新计划出价修改taobao.universalbp.new.campaign.onebpdisplay.batchupdate本站详情 →官方文档 ↗
批量更新计划三维出价修改taobao.universalbp.new.campaign.wholebid.batchupdate本站详情 →官方文档 ↗
数据报表(report) 19 个接口
用途类型method本站接口文档淘宝官方文档
账户报表查询查询taobao.universalbp.new.report.query.account本站详情 →官方文档 ↗
计划报表查询查询taobao.universalbp.new.report.query.campaign本站详情 →官方文档 ↗
宝贝主体报表查询查询taobao.universalbp.new.report.query.item.promotion本站详情 →官方文档 ↗
实时报表查询查询taobao.universalbp.new.report.query.realtime本站详情 →官方文档 ↗
地域报表查询查询taobao.universalbp.new.report.query.area本站详情 →官方文档 ↗
创意报表查询查询taobao.universalbp.new.report.query.creative本站详情 →官方文档 ↗
其他主体报表查询查询taobao.universalbp.new.report.query.not.item.promotion本站详情 →官方文档 ↗
人群报表查询查询taobao.universalbp.new.report.query.crowd本站详情 →官方文档 ↗
关键词报表查询查询taobao.universalbp.new.report.query.bidword本站详情 →官方文档 ↗
单元报表查询查询taobao.universalbp.new.report.query.adgroup本站详情 →官方文档 ↗
账户花费数据汇总查询taobao.universalbp.new.report.chargesum本站详情 →官方文档 ↗
获取下载链接查询taobao.universalbp.new.report.async.download.get.url本站详情 →官方文档 ↗
查询异步下载任务列表查询taobao.universalbp.new.report.async.download.find.task.page本站详情 →官方文档 ↗
创建异步下载任务修改taobao.universalbp.new.report.async.create.download.task本站详情 →官方文档 ↗
实时报表查询(专用,有限制)查询taobao.universalbp.new.report.query.realtime.special本站详情 →官方文档 ↗
计划报表查询(专用-权限限制)查询taobao.universalbp.new.report.query.campaign.special本站详情 →官方文档 ↗
实时报表查询(猫超专用)查询taobao.universalbp.new.report.query.realtime.maochao本站详情 →官方文档 ↗
实时报表查询(直播专用)查询taobao.universalbp.new.report.query.realtime.live本站详情 →官方文档 ↗
实时报表查询(秒杀专用)查询taobao.universalbp.new.report.query.realtime.miaosha本站详情 →官方文档 ↗
投放方案(solution) 2 个接口
用途类型method本站接口文档淘宝官方文档
计划批量创建接口修改taobao.universalbp.new.solution.addlist本站详情 →官方文档 ↗
编辑解决方案修改taobao.universalbp.new.solution.modify本站详情 →官方文档 ↗
推广单元(adgroup) 5 个接口
用途类型method本站接口文档淘宝官方文档
修改单元或主体状态修改taobao.universalbp.new.adgroup.updatepart本站详情 →官方文档 ↗
删除单元或主体修改taobao.universalbp.new.adgroup.delete本站详情 →官方文档 ↗
查询单元分页列表查询taobao.universalbp.new.adgroup.horizontal.findpage本站详情 →官方文档 ↗
批量更新单元或主体出价修改taobao.universalbp.new.adgroup.bid.batchupdate本站详情 →官方文档 ↗
批量添加单元或主体修改taobao.universalbp.new.adgroup.addlist本站详情 →官方文档 ↗
账户与协议(member) 4 个接口
用途类型method本站接口文档淘宝官方文档
查询可用品牌列表查询taobao.universalbp.new.member.findbrandinfolist本站详情 →官方文档 ↗
签署协议修改taobao.universalbp.new.member.sign.protocol本站详情 →官方文档 ↗
是否已签署协议查询taobao.universalbp.new.member.judge.signprotocol本站详情 →官方文档 ↗
是否已签署无界协议查询taobao.universalbp.new.member.judge.sign.bp.protocol本站详情 →官方文档 ↗
推荐建议(suggest) 1 个接口
用途类型method本站接口文档淘宝官方文档
关键词建议出价查询taobao.universalbp.new.suggest.bidword.price本站详情 →官方文档 ↗
关键词出价(bidword) 7 个接口
用途类型method本站接口文档淘宝官方文档
批量修改关键词修改taobao.universalbp.new.bidword.update本站详情 →官方文档 ↗
关键词建议查询taobao.universalbp.new.bidword.suggestkrlist本站详情 →官方文档 ↗
建议默认关键词查询taobao.universalbp.new.bidword.suggestdefaultlist本站详情 →官方文档 ↗
实时质量分查询查询taobao.universalbp.new.bidword.qscore本站详情 →官方文档 ↗
词列表查询查询taobao.universalbp.new.bidword.findlist本站详情 →官方文档 ↗
批量删除关键词修改taobao.universalbp.new.bidword.delete本站详情 →官方文档 ↗
批量添加关键词修改taobao.universalbp.new.bidword.add本站详情 →官方文档 ↗
标签(label) 6 个接口
用途类型method本站接口文档淘宝官方文档
定向标签列表(分页)查询taobao.universalbp.new.label.findpage本站详情 →官方文档 ↗
定向标签列表(全量)查询taobao.universalbp.new.label.findlist本站详情 →官方文档 ↗
DMP定向转换查询taobao.universalbp.new.label.dmpconvert本站详情 →官方文档 ↗
基于dmp配置获取dmp人群查询taobao.universalbp.new.label.dmp.finddmpcrowdbymoduleconfig本站详情 →官方文档 ↗
查询dmp浮层配置查询taobao.universalbp.new.label.dmp.finddmpmoduleconfig本站详情 →官方文档 ↗
查询可用标签id信息查询taobao.universalbp.new.label.findconfiglist本站详情 →官方文档 ↗
词包(wordpackage) 6 个接口
用途类型method本站接口文档淘宝官方文档
关键词包建议查询taobao.universalbp.new.wordpackage.suggestkrlist本站详情 →官方文档 ↗
批量更新词包修改taobao.universalbp.new.wordpackage.update本站详情 →官方文档 ↗
建议默认关键词包查询taobao.universalbp.new.wordpackage.suggestdefaultlist本站详情 →官方文档 ↗
词包列表查询查询taobao.universalbp.new.wordpackage.findlist本站详情 →官方文档 ↗
删除词包修改taobao.universalbp.new.wordpackage.delete本站详情 →官方文档 ↗
批量添加词包修改taobao.universalbp.new.wordpackage.add本站详情 →官方文档 ↗
人群(crowd) 9 个接口
用途类型method本站接口文档淘宝官方文档
修改人群状态修改taobao.universalbp.new.crowd.horizontal.modifystatus本站详情 →官方文档 ↗
修改人群出价修改taobao.universalbp.new.crowd.horizontal.modifybidprice本站详情 →官方文档 ↗
修改人群溢价修改taobao.universalbp.new.crowd.horizontal.modifydiscount本站详情 →官方文档 ↗
查询推荐人群查询taobao.universalbp.new.crowd.findrecommendcrowd本站详情 →官方文档 ↗
横向管理人群分页查询查询taobao.universalbp.new.crowd.horizontal.findpage本站详情 →官方文档 ↗
查询人群绑定列表查询taobao.universalbp.new.crowd.findlist本站详情 →官方文档 ↗
批量编辑人群修改taobao.universalbp.new.crowd.batchmodify本站详情 →官方文档 ↗
批量删除绑定人群修改taobao.universalbp.new.crowd.batchdelete本站详情 →官方文档 ↗
获取完整人群定向结构查询taobao.universalbp.new.crowd.generalcrowdconvert本站详情 →官方文档 ↗
广告创意(creative) 18 个接口
用途类型method本站接口文档淘宝官方文档
从创意库添加查询创意列表查询taobao.universalbp.new.creative.getcreativebyconditionmap本站详情 →官方文档 ↗
创意库查询创意列表查询taobao.universalbp.new.creative.manage.findmanagepage本站详情 →官方文档 ↗
创建创意必要信息接口查询taobao.universalbp.new.creative.findrequire本站详情 →官方文档 ↗
预览创意查询taobao.universalbp.new.creative.preview本站详情 →官方文档 ↗
创建单品创意前置信息查询taobao.universalbp.new.creative.preadd本站详情 →官方文档 ↗
横向管理创意分页查询查询taobao.universalbp.new.creative.horizontal.findpage本站详情 →官方文档 ↗
计划已绑定创意查询查询taobao.universalbp.new.creative.getbindcreativelist本站详情 →官方文档 ↗
编辑创意修改taobao.universalbp.new.creative.update本站详情 →官方文档 ↗
创建创意修改taobao.universalbp.new.creative.add本站详情 →官方文档 ↗
绑定创意修改taobao.universalbp.new.creative.bind本站详情 →官方文档 ↗
创意库创意部分编辑修改taobao.universalbp.new.creative.updatepart本站详情 →官方文档 ↗
保存创意和模板信息修改taobao.universalbp.new.creative.updatecreativeandtemplate本站详情 →官方文档 ↗
解绑创意修改taobao.universalbp.new.creative.unbind本站详情 →官方文档 ↗
创意角色判断查询taobao.universalbp.new.creative.check.role本站详情 →官方文档 ↗
素材报表查询taobao.universalbp.new.creative.report.material本站详情 →官方文档 ↗
设置流量分配修改taobao.universalbp.new.creative.update.rotation本站详情 →官方文档 ↗
更新素材有效时间修改taobao.universalbp.new.creative.update.material.time本站详情 →官方文档 ↗
更新素材信息(更新素材名称)修改taobao.universalbp.new.creative.update.material本站详情 →官方文档 ↗
屏蔽设置(shield) 1 个接口
用途类型method本站接口文档淘宝官方文档
风控检查文本准入查询taobao.universalbp.new.shield.textjudge本站详情 →官方文档 ↗
广告资源位(adzone) 3 个接口
用途类型method本站接口文档淘宝官方文档
查询所有可用资源包信息查询taobao.universalbp.new.adzone.findconfiglist本站详情 →官方文档 ↗
查看资源包列表查询taobao.universalbp.new.adzone.horizontal.findpage本站详情 →官方文档 ↗
横向管理查看资源包列表查询taobao.universalbp.new.adzone.aggregated.findlist本站详情 →官方文档 ↗
标准类目(stdcategory) 2 个接口
用途类型method本站接口文档淘宝官方文档
获取类目过滤条件查询taobao.universalbp.new.stdcategory.findcategorycondition本站详情 →官方文档 ↗
宝贝所属类目查询查询taobao.universalbp.new.stdcategory.findlist本站详情 →官方文档 ↗
店铺类目(shopcategory) 1 个接口
用途类型method本站接口文档淘宝官方文档
店铺相关类目查询查询taobao.universalbp.new.shopcategory.findlist本站详情 →官方文档 ↗
计划组(campaigngroup) 3 个接口
用途类型method本站接口文档淘宝官方文档
编辑计划组修改taobao.universalbp.new.campaigngroup.modify本站详情 →官方文档 ↗
查询计划组列表查询taobao.universalbp.new.campaigngroup.findlist本站详情 →官方文档 ↗
新增计划组修改taobao.universalbp.new.campaigngroup.add本站详情 →官方文档 ↗
算法能力(algo) 5 个接口
用途类型method本站接口文档淘宝官方文档
获取出价建议查询taobao.universalbp.new.algo.getbidsuggestion本站详情 →官方文档 ↗
批量获取出价建议查询taobao.universalbp.new.algo.getbatchbidsuggestion本站详情 →官方文档 ↗
预算预估查询taobao.universalbp.new.algo.getbudgetsuggestion本站详情 →官方文档 ↗
成效预估查询taobao.universalbp.new.algo.geteffectprediction本站详情 →官方文档 ↗
成效预估(专用-权限限制)查询taobao.universalbp.new.algo.geteffectprediction.special本站详情 →官方文档 ↗
通用能力(commonapi) 1 个接口
用途类型method本站接口文档淘宝官方文档
查询地域码表查询taobao.universalbp.new.commonapi.getcodeconfig本站详情 →官方文档 ↗
投放诊断(diagnose) 3 个接口
用途类型method本站接口文档淘宝官方文档
计划总诊断计划数查询taobao.universalbp.new.diagnose.highlight本站详情 →官方文档 ↗
查询单元故障信息查询taobao.universalbp.new.diagnose.adgroup.faultlist本站详情 →官方文档 ↗
查询计划故障信息查询taobao.universalbp.new.diagnose.campaign.faultlist本站详情 →官方文档 ↗
校验(check) 2 个接口
用途类型method本站接口文档淘宝官方文档
是否已升级UC Schema查询taobao.universalbp.new.check.complete.scene本站详情 →官方文档 ↗
通用角色查询查询taobao.universalbp.new.check.universal.role本站详情 →官方文档 ↗
屏蔽词(blackword) 2 个接口
用途类型method本站接口文档淘宝官方文档
屏蔽词查询查询taobao.universalbp.new.blackword.find本站详情 →官方文档 ↗
屏蔽词更新修改taobao.universalbp.new.blackword.update本站详情 →官方文档 ↗
潜力数据(potential) 1 个接口
用途类型method本站接口文档淘宝官方文档
查询潜力关键词列表查询taobao.universalbp.new.potential.bidword.find本站详情 →官方文档 ↗
商品关联(itemcross) 1 个接口
用途类型method本站接口文档淘宝官方文档
查询商品的投放信息查询taobao.universalbp.new.itemcross.promotion.find本站详情 →官方文档 ↗
关键词(word) 2 个接口
用途类型method本站接口文档淘宝官方文档
市场趋势-通过词取相关类目查询taobao.universalbp.new.word.gategory.find本站详情 →官方文档 ↗
市场趋势-指标分日详情查询taobao.universalbp.new.word.index.detail本站详情 →官方文档 ↗
模板(template) 1 个接口
用途类型method本站接口文档淘宝官方文档
查询推荐模板查询taobao.universalbp.new.template.getsuggest本站详情 →官方文档 ↗
屏蔽人群(blackcrowd) 3 个接口
用途类型method本站接口文档淘宝官方文档
批量编辑人群修改taobao.universalbp.new.blackcrowd.batchmodify本站详情 →官方文档 ↗
查询人群绑定列表查询taobao.universalbp.new.blackcrowd.findlist本站详情 →官方文档 ↗
批量删除绑定人群修改taobao.universalbp.new.blackcrowd.batchdelete本站详情 →官方文档 ↗

接口测试页提供参数结构模板,需按官方文档补全必填内容。不要把空对象、占位文字或示例编号当成正式业务参数。top_service_context.biz_code 要使用当前店铺实际可用的推广场景,可先调用“查询可用推广场景”确认。

创建、预算出价、启停和删除

这些操作会实际改变店铺的投放数据,在线测试与代码调用都不是模拟环境。先查询目标对象,核对店铺、计划或单元编号以及预算、出价、状态等字段,再执行修改;金额单位和允许范围以该方法的官方文档为准。

网页选择修改类方法后会显示操作提示,并在发送前展示店铺、完整方法名和本次 JSON 参数,确认一次后执行。查询类接口直接执行。复制的修改类 Python 示例也会在运行时要求键入 CONFIRM 后才发送。

自己编写的程序调用公共 API 时,请在程序中设置操作确认或明确的业务审批流程。遇到超时、连接中断或结果不明确时,先查询实际状态,再决定是否重试;不要自动重试创建、扣费或删除等写入操作。

时间范围和分页

在对应报表参数对象中设置 start_time、end_time 和分页参数。按方法要求选择日期范围、推广场景和统计口径;当天分时数据与历史日报是不同方法。

查询当天分时数据前,先用“分页查询推广计划”获取真实的 campaign_id,再替换模板中 strategy_campaign_id_in_list 的占位内容。不要直接提交占位文字。

一次签名只生成一份查询请求,由你的程序直接请求淘宝,不自动翻页或把整个时间段拉完。需要全量数据时,按照该方法的分页结果继续请求,并以接口返回的数据主键去重。不要把空列表直接理解为没有投放,先检查日期、场景和授权范围。

失败时怎么处理

现象处理方式
密钥无效或账户停用检查 Authorization 请求头及服务台密钥;重置密钥后所有使用旧密钥的程序都要更新。
万相台服务未开通或已到期购买万相台套餐或联系管理员续期。奇门服务有效不能代替万相台服务。
店铺不存在、已解绑或不属于当前账号使用该账户服务台显示的 shopKey;已解绑的店铺需要重新授权。
WANXIANG_AUTH_EXPIRED回到服务台重新授权淘宝店铺。
WANXIANG_SUBSCRIPTION_REQUIRED检查该店铺在淘宝平台的应用订购状态,并联系管理员确认应用匹配。
WANXIANG_SUBSCRIPTION_UNVERIFIED平台订购状态暂时无法确认,保留返回错误并联系管理员排查。
淘宝业务错误或空数据检查完整业务返回,包括错误码、日期范围、分页和推广场景;HTTP 200 不一定代表业务查询成功。

给 AI 的签名直连接入要求

先在接口目录打开所需方法的“本站详情”,将该页的完整参数说明和下方接入要求复制给开发人员或 AI,并提供服务台生成的示例。业务字段按官方层级填写,调用地址和鉴权采用本站规则;密钥仅保存在自己的本地配置或服务端环境变量中。

请为我的程序接入奇门云万相台 API:
1. 下载 https://api.miandanni.com/examples/qimenyun_direct.py 与业务脚本同目录,使用 Client.call("wanxiang", body)。签名地址为 https://api.miandanni.com/api/wanxiang/sign。
2. 申请签名时 Authorization 使用 Bearer 奇门云密钥;正文为 {shopKey, method, params}。SDK 按签发的 data.request 直接请求淘宝,客户密钥不能转发淘宝。
3. 密钥从环境变量或本地私密配置读取,不写入前端,不在日志中打印。
4. 保留 shopKey、计划及商品编号的字符串精度;按具体方法处理日期和分页。
5. 同时判断 HTTP 状态和淘宝业务错误,失败不得当作空列表。
6. 不自行计算淘宝签名,不要求用户提供 AppSecret 或 Token。
7. 业务接口遵循淘宝官方万相台文档;本站目录为接入索引。若官方方法尚未同步导致 METHOD_NOT_ALLOWED,保留方法名和官方链接反馈同步,不误判为淘宝权限不足。
8. 修改操作必须先确认目标店铺、对象和参数。创建、预算出价调整、启停、删除会实际生效,禁止默认自动执行。
9. 修改请求超时或结果不明确时先查询实际状态,不要直接自动重试。按官方说明补全必填参数并核对金额单位。
10. 阅读所选接口详情并对照淘宝官方文档,保持业务字段名称、类型、必填规则和嵌套层级。签发成功不是执行成功,业务结果由淘宝直接返回客户服务器;自己的店铺访问凭据不可进入前端或日志。