接入教程

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

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

使用 AI 对接,不用从头学代码

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

让 AI 帮我接入 →

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

旺店通企业版接入

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

平台授权指引 ↗
  1. 1

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

  2. 2

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

  3. 3

    保存下面的 Python 示例,填入你的奇门云密钥、SID 和订单号,然后运行。

配置填什么

appkey
保持 34608423。由奇门云服务器选择应用,示例不校验这个值。
appsecret
到服务台“奇门云密钥”复制自己的密钥;真实奇门密钥由服务器保管。
sid
填你自己的旺店通卖家账号,需要与奇门云已启用的绑定一致。
method
查询订单用 wdt.trade.query;换接口时,同时修改 PARAMS。
src_tid
原平台订单号,保留英文引号,不要改成数字。

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

想先确认能否获取订单?去订单测试,输入订单号直接查询 →

Python 查单示例Python 3.9+ · 无需安装依赖

只需修改 CONFIG 和 PARAMS,其余代码保留即可。

# 旺店通企业版查单示例:Python 3.9+,无需安装依赖
# 保存为 qimenyun_wangdian.py,修改 CONFIG 和 PARAMS 后运行。
import json
from urllib import error, request

CONFIG = {
    "url": "https://api.miandanni.com/api/gateway",
    "appsecret": "你的奇门云密钥",
    "appkey": "34608423",  # 保持默认,无需校验
    "sid": "你的SID",
    "method": "wdt.trade.query",
    "timeout": 30,
}

PARAMS = {
    "src_tid": "你的订单号",  # 原平台订单号,保留引号
}


class NoRedirect(request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None


def call_api():
    if not isinstance(CONFIG["sid"], str) or not CONFIG["sid"].strip() or CONFIG["sid"] == "你的SID":
        raise RuntimeError("请填写自己的 sid")
    payload = {
        "sid": CONFIG["sid"],
        "method": CONFIG["method"],
        "params": PARAMS,
    }
    req = request.Request(
        CONFIG["url"],
        data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
        headers={
            "Content-Type": "application/json; charset=utf-8",
            "Authorization": "Bearer " + CONFIG["appsecret"],
        },
        method="POST",
    )
    try:
        with request.build_opener(NoRedirect()).open(req, timeout=CONFIG["timeout"]) as response:
            result = json.load(response)
    except error.HTTPError as exc:
        if exc.code == 401:
            raise RuntimeError("奇门云密钥无效或账号已停用,请检查 appsecret") from None
        if exc.code == 402:
            raise RuntimeError("奇门云服务未开通或已到期,请到服务台开通或续费") from None
        detail = exc.read().decode("utf-8", errors="replace")
        raise RuntimeError(f"HTTP {exc.code}: {detail}") from None
    except (error.URLError, TimeoutError):
        raise RuntimeError("连接超时或网络不可用,请检查网络后重试") from None
    except (ValueError, UnicodeError):
        raise RuntimeError("请检查 CONFIG 是否填写完整,以及接口返回是否为 JSON") from None
    if not isinstance(result, dict):
        raise RuntimeError("接口返回格式异常,预期为 JSON 对象")
    business = result.get("error_response") or result.get("response") or result
    if isinstance(business, dict):
        code = business.get("errorcode", business.get("code"))
        if "error_response" in result or code not in (None, 0, "0"):
            raise RuntimeError("平台返回错误:" + json.dumps(business, ensure_ascii=False))
    return result


if __name__ == "__main__":
    try:
        print(json.dumps(call_api(), ensure_ascii=False, indent=2))
    except RuntimeError as exc:
        raise SystemExit(str(exc))

如何运行

将文件保存到电脑,填好密钥、SID和订单号。在文件所在文件夹打开终端,输入:

python qimenyun_wangdian.py

运行后会显示平台返回的 JSON。订单号请保留英文引号;如果没有查到,先核对订单号和平台账号。

运行报错时,先检查这几项
密钥无效(401)
检查 appsecret 是否为自己的奇门云密钥;重新生成密钥后,旧密钥会失效。
服务未开通或到期(402)
前往服务台购买或续费套餐,付款确认后再试。
找不到绑定 / 绑定未启用
检查配置是否对应当前账号下已启用的绑定。新绑定保存后立即启用;如果已被停用,请联系管理员确认原因。
平台返回错误
按返回信息核对平台授权、接口权限和查询条件。更换 method 时,需要同时使用对应接口的 PARAMS。

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

进入服务台 →