子比主题商城API接口插件 – 产品介绍文档

产品简介

什么是”商城API接口”？

商城API接口是一款专为 WordPress 子比主题（Zibll） 商城模块设计的增强型插件。它解决了虚拟商品销售中󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟的自动化发货难题。

它能帮您做什么？

想象一下这个场景：

您在网上销售游戏充值卡、软件激活码、会员账号等虚拟商品。每次有客户下单后，您都需要󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟：

1. 手动登录第三方卡密平台
2. 查找订单对应的商品
3. 复制卡密或账号信息
4. 回到󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟WordPress后台手动填写发货内容
5. 点击发送通知给客户…

如果一天有100单？您将陷入无休止的重复劳动！

有了本插件，这一切全自动完成：

客户下单支付 → 插件自动调用API获取卡密 → 自动填充发货内容 → 客户立即收到商品
    ⬆️ 全程无需人工干预 ⬆️

为什么选择我们？

核心功能

✨ 五大核心能力

1️⃣ API自动发货引擎

• 支持任意第三方API接口（卡密平󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟台、激活码服务、账号系统等）
• 灵活配置URL、请求头、POST数据
• 智能变量替换（󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟订单号、用户邮箱、金额等12种内置变量）
• 多种成功条件判断机制

2️⃣ 发货重试开关

• 在发货弹窗中添加可视化开关控件
• 一键控制是否重新调用API
• 开启时：先调API再发货
• 关闭时：仅执行正常发货流程
• 失败时自动阻止成功通知发送

3️⃣ 智能通知系统

• API调用失败时立即邮件通知管理员
• 成功时正常向客户发送发货通知
• 支󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟持扩展企业微信、钉钉等渠道（需二次开发）

4️⃣ 完整操作审计

• 记录每一次开关操作的详细信息
• 包含：时间、操作人、订单号、API󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟响应、IP地址等
• 数据保存在订单元数据中，永久可查

5️⃣ 开发者调试工具

• 全局调试开关（API_DEBUG）
• 浏览器端实时日志查看器
• 前后端状态同步显示
• 生产环境零噪音输出

适用场景

🎯 典型应用案例

场景1：在线销售游戏点卡/充值卡

业务流程：
客户购买"王者荣耀100点券" → 支付宝付款 → 
插件自动调用卡密平台API → 获取充值卡号密码 → 
自动填入发货内容 → 客户收到短信/邮件通知 → 完成！

配置示例：
API地址: https://card-platform.com/api/getCard
POST数据: {"productId": "001", "quantity": "{quantity}"}
成功条件: 返回{"code":0, "data":{"card":"xxx-xxx-xxx"}}

场景2：软件授权码/激活码分发

业务流程：
客户购买"Photoshop 2024激活码" → 微信支付 → 
插件调用授权系统API → 生成唯一激活码 → 
自动发送到客户邮箱 → 客户激活软件 → 完成！

配置示例：
API地址: https://license-server.com/v1/generate
Headers: Authorization: Bearer {your_token}
POST数据: {"software": "ps2024", "email": "{user_email}", "order": "{order_num}"}

场景3：会员账号/VIP服务开通

业务流程：
客户购买"月度VIP会员" → 支付成功 → 
插件调用用户系统API → 创建VIP账号或升级权限 → 
返回账号密码 → 客户登录使用 → 完成！

高级特性：
- 可在API请求中传递客户邮箱用于自动注册
- 可返回临时密码并提示客户修改
- 可设置VIP到期时间

场景4：网盘/云存储资源分享

业务流程：
客户购买"百度网盘超级会员30天" → 支付 → 
插件调用兑换API → 获取兑换码或直链 → 
自动发货给客户 → 客户激活享受高速下载 → 完成！

注意事项：
- 某些API可能返回临时链接（24小时有效）
- 建议设置合理的发货超时时间

场景5：课程/资料加密链接发放

业务流程：
客户购买"Python零基础入门课" → 支付 → 
插件调用LMS系统API → 生成学习权限/加密链接 → 
通过邮件或站内信发送 → 客户点击开始学习 → 完成！

安全建议：
- 链接设置有效期（如7天）
- 限制访问次数或IP
- 记录下载日志防止滥用

💡 更多可能性

只要您的业务涉及虚拟商品的自动化交付，本插件都能胜任：

• ✅ 电话号码/流量包充值
• ✅ 礼品卡/优惠券发放
• ✅ 在线课程权限开通
• ✅ 软件下载授权
• ✅ API接口调用次数包
• ✅ 代理IP/VPN账号分配
• ✅ 虚拟主机空间开通
• …以及更多！

功能详解

一、API自动发货

工作原理

┌─────────────────────────────────────────────────────┐
│                  API自动发货流程                      │
│                                                     │
│  ① 客户完成支付                                      │
│     ↓                                               │
│  ② WordPress触发 'shop_auto_delivery_content'        │
│     ↓                                               │
│  ③ 插件检测到该商品配置了"API类型"发货                 │
│     ↓                                               │
│  ④ 读取API配置（URL、Headers、Body模板）              │
│     ↓                                               │
│  ⑤ 变量替换引擎工作：                                │
│     {order_id} → 12345                              │
│     {user_email} → client@example.com               │
│     {pay_price} → 99.00                             │
│     ↓                                               │
│  ⑥ 发送HTTP请求到第三方API                            │
│     ↓                                               │
│  ⑦ 接收并解析响应                                   │
│     ↓                                               │
│  ⑧ 判断是否成功（根据配置的条件）                     │
│     ├─ 成功 → 提取卡密/账号等信息                    │
│     │   ↓                                           │
│     │ ⑨ 构建HTML格式的发货内容                       │
│     │   ↓                                           │
│     │ ⑩ 返回给主题，完成发货流程                     │
│     │                                               │
│     └─ 失败 → 记录错误日志                          │
│         ↓                                           │
│         发送邮件通知管理员                           │
│         标记订单为"待处理"                           │
└─────────────────────────────────────────────────────┘

支持的变量列表

在配置API时，您可以使󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟用以下占位符，它们会在实际请求时被替换为真实值：

配置示例

示例1：简单的GET请求

【API地址】
https://api.cardshop.com/fetch?orderid={order_num}&pid={product_id}

【请求方法】
GET

【说明】
这是一个最简单的配置，只需填写URL即可。
适用于：不需要认证的公开API，或参数已在URL中包含的情况。

示例2：带认证的POST请求

【API地址】
https://license.example.com/v1/generate

【请求方法】
POST

【请求头】
Authorization: Bearer sk_live_abc123xyz789
Content-Type: application/json
X-Custom-Header: DwyPlugin/{version}

【POST数据】
{
  "product": "{product_name}",
  "buyer_email": "{user_email}",
  "amount": {pay_price},
  "order_no": "{order_num}",
  "callback_url": "{site_url}/wp-json/dwy-api/callback"
}

【成功条件】
字段: code
期望值: 0

示例3：表单格式提交

【API地址】
https://old-system.com/api/deliver.php

【请求方法】
POST

【请求头】
Cookie: sessionid=your_session_key

【POST数据】（非JSON，表单格式）
action=create&oid={order_num}&uid={user_id}&price={pay_price}&time={current_time}

二、发货重试开关

这是什么？

当首次API自动发货失败时（比如网络波动、卡密平台临󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟时故障），您可以在手动发货界面看到一个开关控件：

┌─────────────────────────────────────────────────┐
│  备注：可选填写备注信息                             │
│  ┌───────────────────────────────────────────┐  │
│  │                                          │  │
│  └───────────────────────────────────────────┘  │
│                                                 │
│  ┌───────────────────────────────────────────┐  │
│  │ 🔄 重新调用API发货            [○ 开关]     │  │
│  │                                         │  │
│  │ 开启后，提交时会重新向API发起请求...       │  │
│  │                                         │  │
│  │ ⚠️ 注意：重复调用可能会产生额外费用       │  │ ← 开启时显示
│  └───────────────────────────────────────────┘  │
│                                                 │
│           [确认提交]                             │
└─────────────────────────────────────────────────┘

两种模式对比

什么时候应该开启它？

✅ 适合开启的场景:

• 首次自动发货失败了（订单显示”待处理󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟”）
• 卡密平台刚刚恢复服务
• 您想测试API配置是否正确
• 需要重新为客户发货（之前的卡密有问题）

❌ 不建议开启的场景:

• 正常的手动发货（不需要调用API）
• 已经成功发货过的订单（避免重复）
• 不确定API是否会扣费/消耗库存
• 测试环境（除非确实要测试）

安全保障

• 确认对话框：开启后提交会弹出警告，防止误操作
• 失败保护：如果API再次失败，不会向客户发送”请查收商品”的通知
• 操作记录：所有重试操作都会记录日志，可追溯

三、智能通知系统

通知逻辑

API调用结果
    ↓
┌─────────────────┬─────────────────────────────┐
│ ✅ 成功          │ ❌ 失败                      │
│                 │                             │
↓                ↓                               ↓
正常发货流程      阻止发货流程                   发送邮件给管理员
↓                ↓                               ↓
客户收到：        客户收到：（无）                 管理员收到：
"您的订单已发货，  （不会发送成功通知）             "🚨 API发货失败提醒"
 请查收..."                                       订单号：xxx
                                                  商品：xxx
                                                  错误原因：Connection timeout
                                                  时间：2026-05-12 15:30
                                                  请及时处理！

邮件通知内容示例

主题: [重要] 商城API接口 - 发货失败通知

正文:

尊敬的管理员，

您好！

系统在执行订单发货时遇到API调用失败，详情如下：

═══════════════════════════════════════
📋 订单信息
═══════════════════════════════════════
  订单编号：2605092307333031507
  商品名称：VIP会员月卡（30天）
  购买者：user123 (user@example.com)
  支付金额：¥99.00
  
═══════════════════════════════════════
❌ 错误详情
═══════════════════════════════════════
  错误类型：HTTP请求失败
  错误代码：http_request_failed
  错误消息：Connection timed out after 30 seconds
  
  API地址：https://api.example.com/deliver
  请求方法：POST
  
═══════════════════════════════════════
👤 操作信息
═══════════════════════════════════════
  操作人：Admin (ID: 1)
  操作时间：2026-05-12 15:30:22
  客户端IP：192.168.1.100

═══════════════════════════════════════

请您尽快检查API服务是否正常运行，或手动处理此订单。

---
此邮件由 商城API接口插件 自动发送
如有疑问请联系网站管理员

四、完整操作日志

为什么需要日志？

1. 追溯问题：客户说没收到货？查看日志确认API是否真的被调用󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟了
2. 审计合规：记录谁在什么时间做了什么操作
3. 数据分析：统计API成功率、常见错误类型
4. 纠纷处理：提供客观的操作证据

日志包含哪些信息？

每条日志记录包含以下字段：

{
  "log_id": "toggle_6465f234abc123",
  "time": "2026-05-12 15:30:00",
  "status": "success",           // success / failed / exception
  "operator_id": 1,
  "operator_name": "管理员",
  
  "order_num": "2605092307333031507",
  "product_name": "VIP会员月卡",
  "product_id": 123,
  "user_id": 45,
  "pay_price": 99.00,
  
  "api_url": "https://api.example.com/deliver",
  "api_method": "POST",
  "result_message": "发货成功",
  "api_response": {...},          // API原始响应（可能很大）
  "error_code": null,
  
  "ip_address": "192.168.1.100"
}

如何查看日志？

方法1：通过数据库查询

// 在主题functions.php中临时添加（测试用）
add_action('admin_notices', function() {
    if (!isset($_GET['view_order_log'])) return;
    
    $order_id = (int)$_GET['view_order_log'];
    $logs = zibpay::get_meta($order_id, 'dwy_api_toggle_log');
    
    echo '<div class="notice notice-info"><pre>';
    print_r($logs);
    echo '</pre></div>';
});
// 访问：/wp-admin/?view_order_log=订单ID

方法2：开发者在代码中读取

$logs = zibpay::get_meta(12345, 'dwy_api_toggle_log');
foreach ($logs as $log) {
    echo $log['time'] . ' - ' . $log['status'] . ': ' . $log['result_message'];
}

五、开发者调试工具

什么是API_DEBUG？

这是一个全局开关，类似于WordPress自带󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟的 WP_DEBUG，但专门用于控制本插件的调试输出。

如何使用？

步骤1：打开 wp-config.php 文件

位置：/www/wwwroot/example.com/wp-config.php（大约第78行）

步骤2：找到 WP_DEBUG 定义附近，添加：

/**
 * WordPress调试模式
 */
define( 'WP_DEBUG', false );

/**
 * ⭐ 商城API接口调试开关 【新增这一行】
 * 
 * false = 关闭（生产环境推荐）：仅显示严重错误
 * true  = 开启（开发调试用）：显示所有详细信息
 */
define( 'API_DEBUG', false );  // ← 在这里添加

步骤3：保存文件，刷新后台页面

开启后会看到什么？

浏览器控制台（按F12打开）：

[商城API接口] [INFO] 🚀 脚本开始加载...
[商城API接口] [INFO] 调试模式: ✅ 已开启
[商城API接口] [INFO] 调试来源: API_DEBUG
[商城API接口] [INFO] 配置时间戳: 2026-05-12 15:29:59
[商城API接口] [INFO] ✅ MutationObserver已启动
...
✨ [商城API接口] 调试工具已加载 v0.0.3
🔧 调试模式: 已开启 (API_DEBUG=true)

📋 可用命令:
   DwyApiDebug.getStatus()         - 查看完整状态
   DwyApiDebug.logInfo()           - 显示详细报告
   DwyApiDebug.forceInject()       - 强制注入开关
   DwyApiDebug.testAjaxInterception() - 测试AJAX拦截器

PHP错误日志（如果开启󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟了WP_DEBUG_LOG）：

[12-May-2026 15:30:00 UTC] [商城API接口] [INFO] 2026-05-12 15:30:00 🔧 调试模式已开启 (通过 API_DEBUG 常量)
[12-May-2026 15:30:06 UTC] [商城API接口] [INFO] 2026-05-12 15:30:06 ✅ 检测到开关已开启，开始处理API调用
[12-May-2026 15:30:07 UTC] [商城API接口] [INFO] 2026-05-12 15:30:07 🔄 开始调用API | Context: {"order_id":12345,"api_url":"https://..."}
[12-May-2026 15:30:08 UTC] [商城API接口] [ERROR] 2026-05-12 15:30:08 ❌ API请求失败 | Context: {"message":"Connection timed out"}

何时应该开启？

安装指南

系统要求

安装步骤

方法1：通过WordPress后台安装（推荐）

1. 登录WordPress管理后台
2. 进入 插件 → 安装插件
3. 点击 上传插件
4. 选择下载好的 .zip 压缩包
5. 点击 现在安装
6. 安装完成后点击 启用插件

方法2：通过FTP/SFTP上传

1. 解压下载的 .zip 文件
2. 使用F󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟TP客户端（如FileZilla）连接服务器
3. 进入 /wp-content/plugins/ 目录
4. 上传整个 zibll-dwy-api 文件夹
5. 进入WordPress后台 → 插件 → 找到”商城A󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟PI接口”
6. 点击 启用

方法3：通过命令行安装（适用于有SSH权限的用户）

# 进入插件目录
cd /www/wwwroot/example.com/wp-content/plugins/

# 下载插件（假设您有zip文件的URL）
wget https://example.com/zibll-dwy-api.zip

# 解压
unzip zibll-dwy-api.zip

# 设置正确的权限（重要！）
chmod -R 755 zibll-dwy-api/
chown -R www:www zibll-dwy-api/

# 清理压缩包
rm zibll-dwy-api.zip

然后去后台启用插件即可。

安装后验证

安装并启用后，您应该能看到：

1. 插件列表中出现”商城API接口”，版本号为 v0.0.3
2. 没有红色错误提示（如果看到”需要子比主题”的错误，说明󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟未安装子比主题）
3. 进入订单管理页面，打开发货弹窗，能看到新增的开关控件

快速开始

5分钟快速上手教程

让我们以一个实际的例子来演示如何󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟配置和使用本插件。

准备工作

假设您经营一家在线游戏充值卡商店，使用某卡密平台的API来获取充󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟值卡号。

您已拥有的信息：

• 卡密平台提供的API文档
• 您的API密钥（API Key / Tok󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟en）
• 商品在您网站上的ID

第1步：编辑商品设置

1. 进入WordPress后台
2. 导航到 子比主题 → 商城管理 → 商品
3. 找到要配置的商品（例如”王者荣耀1󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟00点券”），点击 编辑
4. 向下滚动找到 “自动发货” 设置区域

第2步：选择发货类型

在”自动发货”下拉框中选择 “API类型”

第3步：填写API配置

根据卡密平台提供的文档，填写以下信息：

【基本信息】
✅ 发货类型：API类型

【API配置】
✅ API地址：https://api.card-platform.com/v1/card/get
✅ 请求方法：POST

【请求头（可选）】
Authorization: Bearer your_api_key_here
Content-Type: application/json

【POST数据】
{
  "productCode": "wzry_100",
  "quantity": "{quantity}",
  "orderId": "{order_num}",
  "notifyUrl": "{site_url}/notify"
}

【成功条件】
✅ 判断方式：字段值匹配
✅ 字段名：code
✅ 期望值：0

解释：

• API地址：卡密平台提供的接口地址
• Authorization：您的API密钥，用于身份验证
• POST数据：发送给API的参数，其中 {quantity} 和 {order_num} 会被替换为真实值
• 成功条件：告诉󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟插件如何判断API返回的是成功还是失败（通常 code=0 表示成功）

第4步：保存商品设置

点击 更新/发布 按钮保存配置。

第5步：测试（重要！）

不要直接用真实订单测试！ 建议按以下步骤：

1. 创建一个测试商品（价格设为 ¥0.01 或使用优惠券）
2. 用自己的账号下单购买
3. 观察是否自动发货成功
4. 检查收到的发货内容是否正确
5. 如果失败，查看错误日志并󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟根据提示调整配置

第6步：正式上线

测试无误后，就可以开放给真正的客户购买了󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟！

配置教程

高级配置选项详解

1. HTTP方法选择

大多数情况下使用 POST 即可。

2. 请求头（Headers）配置

常见的请求头及其用途：

# 身份认证
Authorization: Bearer your_token          # OAuth2令牌认证
X-API-Key: your_api_key                   # 自定义API密钥
Cookie: sessionid=xxx                      # 会话认证

# 内容类型
Content-Type: application/json            # JSON格式（最常用）
Content-Type: application/x-www-form-urlencoded  # 表单格式
Content-Type: text/plain                  # 纯文本

# 自定义标识
User-Agent: MyShop/1.0                   # 客户端标识
X-Requested-With: XMLHttpRequest         # AJAX请求标识
X-Forwarded-For: {ip_address}            # 透传客户端IP（某些API需要）

注意：每行一个请求头，格式为 Key: Value

3. POST数据格式

JSON格式（推荐，最常用）：

{
  "key1": "value1",
  "key2": "{variable}",
  "number": 123,
  "boolean": true,
  "array": [1, 2, 3],
  "object": {"nested": "value"}
}

表单格式（传统API可能需要）：

key1=value1&key2={variable}&number=123

纯文本（较少见）：

这是任意文本内容，{variable}会被替换

4. 成功条件配置

选项A：字段值匹配（最常用）

适用于API返回类似这样的结构：

{"code": 0, "msg": "success", "data": {"card": "xxx-xxx"}}

配置：

• 类型：字段值匹配
• 字段：code
• 期望值：0

选项B：字段存在性检查

适用于：只要有某个字段就认为成功

{"status": "ok", "card_number": "123-456"}

配置：

• 类型：字段存在
• 字段：card_number

选项C：HTTP状态码

适用于：只关心HTTP响应码，不󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟检查body

• 类型：HTTP状态码
• 期望值：200

选项D：默认（不配置）

如果没有配置成功条件，插件会：

• 检查是否有 error 或 errcode 字段
• 如果没有这些字段，就认为成功

5. 超时时间设置

默认值为 30秒，可以根据实际情况调整：

注意：超时时间过长可能导致用户体验差（页面一直󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟转圈）。

常见问题

❓ 一般性问题

Q1: 这个插件免费吗？

A: 是的，本插件完全收费开󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟源，遵循 GPL v2 协议。您可以自由使用、修改和分发。

Q2: 必须使用子比主题吗？

A: 是的，󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟本插件专为子比主题设计，依赖其商城功能和数据结构。不支持其他主题。

Q3: 会影响网站性能吗？

A: 影响极小。仅在订单支付后的󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟发货阶段才工作，平时不消耗任何资源。经过优化，单次API调用增加的耗时 < 100ms。

Q4: 安全吗？会泄露我的API密钥吗？

A: 安全。API密钥存储在WordPress数据库中（商品met󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟a），不会暴露在前端页面。只有具有管理权限的用户才能在后台看到配置。

Q5: 支持哪些类型的API？

A: 支持几乎所有基于HTTP的RESTful API或传统API。只要󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟能通过HTTP请求获取数据就行。

❓ 配置和使用问题

Q6: 配置好后怎么测试？

A: 建议使用小额测试订单：

1. 创建一个价格很低的测试商品（¥0.0󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟1）
2. 用自己的账号购买
3. 观察是否自动发货成功
4. 检查客户收到的通知内容

Q7: API调用失败了怎么办？

A:

1. 查看管理员邮箱（会收到失败通知邮件）
2. 打开订单的发货弹窗，开启重试开关，再次尝试
3. 检查API地址、密钥是否正确
4. 联系API提供商确认服务状态
5. 如需详细日志，临时开启 API_DEBUG = true

Q8: 变量替换不生效？

A: 请检查：

• 变量名拼写是否正确（区分大小写）
• 是否使用了大括号 { } 包裹
• 该变量是否在当前上下文中可用（例如 {custom_field} 需要商品自定义字段支持）

Q9: 可以同时配置多个API吗？

A: 目前一个商品只能配置一个A󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟PI地址。如果需要调用多个API（例如：先获取卡密，再激活），可以考虑：

• 让您的后端程序封装成一个统一的API
• 或者等待后续版本的”多步骤API”功能

Q10: 如何查看历史操作日志？

A: 日志保存在订单的󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟元数据中。可以通过以下方式查看：

• 使用开发者文档中的代码片段
• 安装能够查看post meta的插件（如”Meta Vi󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟ewer”）
• 或联系我们获取日志导出工具

❓ 故障排除

Q11: 开关控件没有显示怎么办？

A: 请按以下步骤排查：

1. 确认插件版本为 v0.0.3 或更高
2. 强制刷新浏览󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟器（Ctrl+Shift+R）
3. 按F12打开控制台，查看是否有错误

Q12: 开启了开关但没有调用API？

A: 这是 v0.0.3 版本修复的问题。如果您使用的是旧版本，请󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟升级到 v0.0.3。新版本使用了AJAX拦截器，确保参数能正确传递。

Q13: API失败了但客户还是收到了成功通知？

A: 这是 v0.0.3 版本修复的关键Bug。请确保您使用的是 v0.0.3 或更高版本。新版本在API󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟失败时会完全终止发货流程。

Q14: 收不到失败通知邮件？

A: 请检查：

1. W󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟ordPress邮件功能是否正常（可以安装 “WP Mail SMTP” 插件测试）
2. 管理员邮箱地址是否正确（󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟在 设置 → 常规 中查看）
3. 邮件是否被扔进了垃圾邮件箱
4. 是否使用了缓存插件（可能延迟发送）

Q15: 控制台输出太多日志太吵了？

A: 在 wp-config.php 中设置：

define( 'API_DEBUG', false );  // 关闭调试，仅显示关键错误

版本历史

v0.0.3 (2026-05-12) – 当前版本

新功能：

• 全局调试开关 (API_DEBUG) – 类似WP_DEB󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟UG的一行配置控制所有日志
• 智能日志分级 – INFO/WARNING/ERROR/󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟CRITICAL四级分类
• 前端DwyLogger – 统一的浏览器端日志管理器
• 生产环境优化 – 关闭调试时零噪音输出

改进：

• 性能提升（减少不必要的IO操作）
• 代码质量（更清晰的注释和结构）
• 文档完善（新增A󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟PI-DEBUG-GUIDE.md）

v0.0.2 (2026-05-12)

修复：

• 修复开关控件不显示的问题
• Mutati󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄡󠄢󠄐󠄡󠄩󠄪󠄤󠄢󠄪󠄢󠄥󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠅒󠅜󠅟󠅗󠄟󠄢󠄠󠄢󠄦󠄟󠄠󠄥󠄟󠄡󠄢󠄟󠄕󠅕󠄥󠄕󠄩󠄥󠄕󠄨󠄦󠄕󠅕󠄥󠄕󠄩󠅖󠄕󠄨󠅕󠅑󠅠󠅙󠄕󠅕󠄦󠄕󠄨󠅕󠄕󠅑󠄥󠄕󠅕󠄥󠄕󠄨󠅖󠄕󠅑󠄣󠄕󠅕󠄦󠄕󠄨󠅖󠄕󠄩󠄢󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠅒󠄦󠄝󠄕󠅕󠄤󠄕󠅒󠅑󠄕󠅑󠄧󠄕󠅕󠄥󠄕󠄩󠄣󠄕󠄨󠄡󠄕󠅕󠄤󠄕󠅒󠅒󠄕󠄨󠅒󠄕󠅕󠄧󠄕󠅒󠅒󠄕󠄨󠅔󠄕󠅕󠄦󠄕󠄩󠄦󠄕󠄨󠄧󠄕󠅕󠄦󠄕󠅑󠄡󠄕󠅑󠄣󠄟onObserver持续监听DOM变化
• 多策略选择器定位算法

关键修复：

• AJAX拦截器解决Vue.js兼容性问题（重要！）
• 重写 $.ajax 透明代理机制
• 动态注入开关参数到请求数据
• API失败时阻止成功通知发送（重要！）
• 新增 send_error_response() 方法
• 钩子优先级调整为最高（1）

v0.0.1 (2026-05-12)

初始发布：

• API自动发货核心功能
• 发货开关控件UI
• 变量替换系统（12种内置变量）
• 错误处理和邮件通知
• 操作日志记录