接入教程

选好平台,照着配置就能开始。

下面是授权步骤和完整查单示例。先看需要填写的几项,再下载代码到本地运行。

程序对接使用签名直连

在服务台生成专属 AI 对接包,店铺和密钥自动配置。奇门云鉴权签名,官方数据直接返回你的服务器;老客户原程序继续可用。

生成 AI 对接包 →直连教程
使用 AI 对接,不用从头学代码

把开发文档和接入要求交给你的 AI,让它帮你配置项目。

让 AI 帮我接入 →

旺店通网页版:接口目录与简单代码 →

万相台 API 接入

授权自己的淘宝店铺,接入已获权限的广告查询、创建、预算出价调整、启停和删除接口。万相台服务单独开通。

万相台教程与示例 →

这里的示例使用签名直连,ERP 业务数据直接返回你的服务器。也可在服务台生成已配置的专属 AI 对接包。查看直连教程 →

旺店通企业版接入

完成授权、绑定账号,再填写配置运行查单示例。

平台授权指引 ↗
  1. 1

    登录慧策开放平台,进入自助对接,按奇门自助指南创建正式授权。卖家账号 sid 填你自己的账号,接口账号 appkey 填 34608423。

  2. 2

    授权上线后,在奇门云添加旺店通企业版,填写相同的 SID,保存后立即启用,再开通服务套餐。

  3. 3

    下载签名客户端与下面的 Python 示例,放在同一文件夹,填入自己的密钥、SID 和订单号后运行。

配置填什么

apiKey
到服务台复制自己的奇门云密钥,只发送到奇门云签名接口;平台 AppSecret 留在服务器。
sid
填你自己的旺店通卖家账号,需要与奇门云已启用的绑定一致。
method
查询订单用 wdt.trade.query;换接口时,同时修改 PARAMS。
src_tid
原平台订单号,保留英文引号,不要改成数字。

旺店通文档里的 trade_query.php 是接口服务名,走奇门时在 CONFIG 中填写 method: "wdt.trade.query"。 查看接口文档 ↗

订单来自旺店通或聚水潭 ERP。网页内测试由服务端执行;程序对接使用签名直连。去订单测试 →

Python 签名直连查单Python 3.9+ · 下载两个文件放在同一目录
① 下载签名客户端

只需修改 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 排查。

准备好了,就去服务台绑定你的平台账号。

进入服务台 →