选好平台,照着配置就能开始。
下面是授权步骤和完整查单示例。先看需要填写的几项,再下载代码到本地运行。
使用 AI 对接,不用从头学代码
让 AI 帮我接入 →把开发文档和接入要求交给你的 AI,让它帮你配置项目。
万相台 API 接入
万相台教程与示例 →授权自己的淘宝店铺,接入已获权限的广告查询、创建、预算出价调整、启停和删除接口。万相台服务单独开通。
这里的示例使用签名直连,ERP 业务数据直接返回你的服务器。也可在服务台生成已配置的专属 AI 对接包。查看直连教程 →
旺店通企业版接入
完成授权、绑定账号,再填写配置运行查单示例。
- 1
登录慧策开放平台,进入自助对接,按奇门自助指南创建正式授权。卖家账号 sid 填你自己的账号,接口账号 appkey 填 34608423。
- 2
授权上线后,在奇门云添加旺店通企业版,填写相同的 SID,保存后立即启用,再开通服务套餐。
- 3
下载签名客户端与下面的 Python 示例,放在同一文件夹,填入自己的密钥、SID 和订单号后运行。
配置填什么
apiKey- 到服务台复制自己的奇门云密钥,只发送到奇门云签名接口;平台 AppSecret 留在服务器。
sid- 填你自己的旺店通卖家账号,需要与奇门云已启用的绑定一致。
method- 查询订单用 wdt.trade.query;换接口时,同时修改 PARAMS。
src_tid- 原平台订单号,保留英文引号,不要改成数字。
旺店通文档里的 trade_query.php 是接口服务名,走奇门时在 CONFIG 中填写 method: "wdt.trade.query"。 查看接口文档 ↗
订单来自旺店通或聚水潭 ERP。网页内测试由服务端执行;程序对接使用签名直连。去订单测试 →
只需修改 CONFIG 和 PARAMS,其余代码保留即可。
# 旺店通企业版签名直连查单:Python 3.9+,无需安装依赖
# 另存 https://api.miandanni.com/examples/qimenyun_direct.py 到本文件同目录。
# 订单数据来自 ERP,通常通过淘宝奇门路由;不使用万相台广告接口。
import json
from qimenyun_direct import Client, CallError, check_result
CONFIG = {
"apiKey": "你的奇门云密钥",
"sid": "你的SID",
"platform": "wangdian_qyb",
"method": "wdt.trade.query",
"timeout": 30,
}
PARAMS = {
"src_tid": "你的订单号", # 原平台订单号保留字符串
}
def call_api(*, display=False):
if not isinstance(CONFIG["sid"], str) or not CONFIG["sid"].strip() or CONFIG["sid"] == "你的SID":
raise RuntimeError("请填写自己的 sid")
if not CONFIG["apiKey"] or CONFIG["apiKey"] == "你的奇门云密钥":
raise RuntimeError("请填写自己的奇门云密钥 apiKey")
client = Client({
"mode": "direct", "apiKey": CONFIG["apiKey"],
"services": {"qimen": {"signEndpoint": "https://api.miandanni.com/api/gateway/sign"}},
}, timeout=CONFIG["timeout"])
try:
result = client.call("qimen", {
"sid": CONFIG["sid"], "platform": CONFIG["platform"],
"method": CONFIG["method"], "params": PARAMS,
})
except CallError as exc:
raise RuntimeError(str(exc) + ": " + client.display(exc.payload)) from None
if not isinstance(result, dict):
raise RuntimeError("接口返回格式异常,预期为 JSON 对象")
try:
check_result(result)
except RuntimeError as exc:
raise RuntimeError(str(exc) + ": " + client.display(result)) from None
return client.display(result) if display else result
if __name__ == "__main__":
try:
print(call_api(display=True))
except (RuntimeError, ValueError) as exc:
raise SystemExit(str(exc))
如何运行
把 qimenyun_direct.py 与查单示例放在同一文件夹,填好密钥、SID和订单号。在该文件夹打开终端,输入:
python qimenyun_wangdian.py运行后会显示平台返回的 JSON。订单号请保留英文引号;如果没有查到,先核对订单号和平台账号。
运行报错时,先检查这几项
- 密钥无效(401)
- 检查 apiKey 是否为自己的奇门云密钥;重新生成密钥后,旧密钥会失效。
- 服务未开通或到期(402)
- 前往服务台购买或续费套餐,付款确认后再试。
- 找不到绑定 / 绑定未启用
- 检查配置是否对应当前账号下已启用的绑定。新绑定保存后立即启用;如果已被停用,请联系管理员确认原因。
- 平台返回错误
- 按返回信息核对平台授权、接口权限和查询条件。更换 method 时,需要同时使用对应接口的 PARAMS。聚水潭提示“企业标识为空”时,核对本绑定的授权 AppKey 与同一行 customer_id,并保留 request_id 排查。
准备好了,就去服务台绑定你的平台账号。
进入服务台 →