商品与图片等电商业务请先查看 淘宝电商已实测接口 →。仅目录中明确列为已实测的方法供优先对接;服务订购和店铺授权不代表所有电商方法均可调用。
授权自己的店铺,接入广告查询与投放管理。
客户购买的奇门云密钥用于接入本站网关;实际调用的是淘宝开放平台万相台官方 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,请提供完整方法名和官方文档链接联系我们同步,不代表淘宝拒绝了你的权限。
接口是否可在当前店铺和推广场景使用,以淘宝实际校验结果为准。购买本站服务不自动授予淘宝平台权限。
先完成这三步
- 注册并登录奇门云,选择“万相台 API”,点击“授权淘宝店铺”。登录你自己的淘宝卖家账号,按淘宝页面提示确认授权。
- 购买万相台套餐。万相台与奇门套餐独立计时:月付 1,000 元、年付 8,000 元、5 年 25,000 元。提交订单后,可联系管理员协商改价,确认金额后付款。
- 在“店铺授权与密钥”中复制奇门云密钥和店铺 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 个接口
推广素材(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 个接口
推广单元(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 个接口
推荐建议(suggest) 1 个接口
关键词出价(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 个接口
广告资源位(adzone) 3 个接口
标准类目(stdcategory) 2 个接口
店铺类目(shopcategory) 1 个接口
计划组(campaigngroup) 3 个接口
算法能力(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 个接口
投放诊断(diagnose) 3 个接口
校验(check) 2 个接口
屏蔽词(blackword) 2 个接口
潜力数据(potential) 1 个接口
商品关联(itemcross) 1 个接口
关键词(word) 2 个接口
模板(template) 1 个接口
接口测试页提供参数结构模板,需按官方文档补全必填内容。不要把空对象、占位文字或示例编号当成正式业务参数。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. 阅读所选接口详情并对照淘宝官方文档,保持业务字段名称、类型、必填规则和嵌套层级。签发成功不是执行成功,业务结果由淘宝直接返回客户服务器;自己的店铺访问凭据不可进入前端或日志。