# 奇门云 API 服务台

> 帮助客户使用自己的奇门云密钥，通过已启用的平台绑定查询旺店通企业版或聚水潭订单。绑定保存后立即启用，上游平台授权仍需完成。适用于 Codex 等 AI 编程助手。

版本：v1。更新日期：2026-09-13。网站：https://api.miandanni.com

## 开始接入

- [AI 接入入口](https://api.miandanni.com/docs/ai)：客户可复制给 AI 的接入任务。
- [完整 AI 接入手册](https://api.miandanni.com/docs/ai-integration.md)：先阅读；包含准备资料、请求合同、密钥保存、验证和错误处理。
- [OpenAPI 3.1 规范](https://api.miandanni.com/openapi.json)：当前两种订单查询请求的机器可读说明。
- [平台授权与配置教程](https://api.miandanni.com/docs)：旺店通企业版与聚水潭的授权步骤、字段说明。

## Python 示例

- [旺店通企业版查单](https://api.miandanni.com/examples/qimenyun_wangdian.py)：`wdt.trade.query`，使用客户自己的 SID。
- [聚水潭查单](https://api.miandanni.com/examples/qimenyun_jushuitan.py)：`jushuitan.order.list.query`，sid 填客户自己的聚水潭 customer_id。

先读取现有项目，只询问缺失资料；无项目时使用 Python。客户可在服务台复制自己的奇门云密钥，程序从客户本地配置读取，不输出、不上传到公共服务，不索取真实淘宝 AppSecret。历史密钥若无法复制，按完整手册说明由客户明确重置，不能自动重置。HTTP 200 仍须检查业务结果。注册、短信验证、付款和平台授权需要客户按页面完成。