Mud.Wechat.MiniProgram
1.0.0
dotnet add package Mud.Wechat.MiniProgram --version 1.0.0
NuGet\Install-Package Mud.Wechat.MiniProgram -Version 1.0.0
<PackageReference Include="Mud.Wechat.MiniProgram" Version="1.0.0" />
<PackageVersion Include="Mud.Wechat.MiniProgram" Version="1.0.0" />
<PackageReference Include="Mud.Wechat.MiniProgram" />
paket add Mud.Wechat.MiniProgram --version 1.0.0
#r "nuget: Mud.Wechat.MiniProgram, 1.0.0"
#:package Mud.Wechat.MiniProgram@1.0.0
#addin nuget:?package=Mud.Wechat.MiniProgram&version=1.0.0
#tool nuget:?package=Mud.Wechat.MiniProgram&version=1.0.0
Mud.Wechat.MiniProgram
微信小程序 SDK 主包:46 个业务域 587 端点(登录与身份 / 二维码与链接 / 内容安全 / 数据分析 / 订阅消息 / 动态消息 / 客服 / 硬件设备 / 运维中心 / 插件 / 付费 / 附近小程序 / 搜一搜 / 生物认证 / 服务市场 / 红包封面 / 学生身份 / 人脸核身 / 用工关系 / 物流助手 / 会员服务 / 交易保障 / 直播 / 短剧媒资 / 虚拟支付 / 发货信息管理与品牌申请 / 小说作品管理 / 实名认证 / 小游戏 / 云开发 / 交易组件 V2(商店账号 / 商品 / 订单 / 售后 / 优惠券 / 资金 / 分享员)/ 基础交易工具 V1(商品目录 / SKU / 订单地址 / 优惠券与抢购 / 装修素材 / 资金)/ 米大师虚拟支付 / 城市服务 / 行业能力)的声明式 HTTP 客户端、模块注册器、AOT JsonContext 合并,以及小程序码 / 反馈图片(二进制流)与物流对账文件(文本)的手工通道。
小程序与公众号同属微信公众平台:同一令牌域、同一批路由前缀(/wxa/、/datacube/、/sns/),因此本线不重复实现令牌与多应用基座,直接复用 Mud.Wechat.OfficialAccount.Abstractions(守卫 MP-X2 锁定)。装配入口也因此是两段式的——先 AddMpApp 建底座,再 AddMiniProgramServices 装本线模块。
能力面(587 端点 = 581 特性路由 + 6 手工通道,计数与路由表由 MP-X5 锁定)
模块(MiniProgramModule) |
注册方法 | 端点 | 接口 |
|---|---|---|---|
Auth |
AddAuthApi() |
8 | IWxaAuthService(8 端点:checksession / resetusersessionkey / getuserphonenumber / getpaidunionid / openpid / 检查加密信息 / encryptKey / sns/jscode2session(方法级 [Token(Disabled = true)] 免应用级令牌,A-7 合并);IWxaCode2SessionService 已 [Obsolete] 过渡保留一版) |
QrCodeLink |
AddQrCodeLinkApi() |
9 | IWxaQrCodeLinkService(URL Link / Scheme / NFC Scheme / 短链 的生成与查询,6 端点走生成管线)+ IWxaCodeService(小程序码 3 端点走手工通道,见下) |
Security |
AddSecurityApi() |
3 | IWxaSecurityService(msg_sec_check 同步文本 + media_check_async 异步媒体 + getuserriskrank) |
DataAnalysis |
AddDataAnalysisApi() |
11 | IWxaDataAnalysisService(/datacube/getweanalysisappid*:日/周/月访问趋势与留存 + 页面访问 + 访问分布 + 用户画像 + 数据概况 + wxa/business/performance/boot) |
SubscribeMessage |
AddSubscribeMessageApi() |
4 | IWxaSubscribeMessageService(发送订阅消息 + 用户通知开关 / 扩展) |
DynamicMessage |
AddDynamicMessageApi() |
3 | IWxaDynamicMessageService(activityid/create + 动态消息发送 + 聊天工具动态卡片消息) |
Kf |
AddKfApi() |
11 | IWxaKfService(客服角色 2 + 客服子商户 4 + 微信客服绑定 3 + 客服输入状态 1)+ IWxaKfMediaService(临时素材二进制手工通道 1;media/get 成功返回素材流、失败才是 JSON,视频素材特例返回含 video_url 的 JSON) |
HardwareDevice |
AddHardwareDeviceApi() |
9 | IWxaHardwareDeviceService(设备消息发送 + getsnticket + 设备组 4 + License 3) |
Operation |
AddOperationApi() |
10 | IWxaOperationService(9 端点:域名配置 / 性能·来源·客户端版本 / 实时与错误日志 / 反馈列表 / 灰度发布)+ IWxaFeedbackMediaService(反馈图片手工通道) |
Plugin |
AddPluginApi() |
2 | IWxaPluginService(/wxa/devplugin、/wxa/plugin,action 驱动) |
Charge |
AddChargeApi() |
2 | IWxaChargeService(资源包用量 + 最近平均用量) |
NearbyPoi |
AddNearbyPoiApi() |
4 | IWxaNearbyPoiService(添加 / 删除地点 + 列表 + 展示状态) |
Search |
AddSearchApi() |
1 | IWxaSearchService(wxaapi_submitpages 搜一搜数据推送) |
Soter |
AddSoterApi() |
1 | IWxaSoterService(SOTER 生物认证秘钥签名验证) |
ServiceMarket |
AddServiceMarketApi() |
2 | IWxaServiceMarketService(调用服务市场接口 + 异步取处理数据) |
RedPacketCover |
AddRedPacketCoverApi() |
1 | IWxaRedPacketCoverService(ctoken 敏感,禁落日志) |
Student |
AddStudentApi() |
1 | IWxaStudentService(快速获取学生身份) |
FaceVerify |
AddFaceVerifyApi() |
2 | IWxaFaceVerifyService(获取 verifyid + 查询验证信息;cert_info 敏感) |
LaborUse |
AddLaborUseApi() |
2 | IWxaLaborUseService(推送用工消息 + 解绑用工关系) |
Express |
AddExpressApi() |
83 | IWxaExpressBusinessService(商家寄件 12)+ IWxaExpressDeliveryService(服务商 / 物流消息 / 退货 / 散单寄件 / 投诉处理 / 消息推送 28)+ IWxaExpressIntracityService(同城配送 16)+ IWxaExpressInsuranceFreightService(无忧退货 11)+ IWxaExpressLocalService(即时配送 15)+ IWxaExpressBillService(对账文件文本手工通道 1;single_waybill/get_bill 成功返回对账文件、失败才是 JSON ⇒ 按 Content-Type 分支判错) |
Vip |
AddVipApi() |
6 | IWxaVipService(会员信息增改查删 4 + 会员列表 1 + 已关联小店列表 1;2026-10 核对为小程序令牌、自小店线设计方案 §4.1 结论 A 划入) |
TransactionGuarantee |
AddTransactionGuaranteeApi() |
16 | IWxaTradeGuaranteeService(交易保障状态 + 违规处罚列表 2,权限集 30)+ IWxaTradeCommentService(评价管理 9:列表 / 详情 / 评论回复列表 3 查走 GET 且参数进 Query + 回复增删 / 评论增删 / 确认和解 / 重置 API 客服 quota 5 写,权限集 151)+ IWxaTradeComplaintService(投诉管理 5:详情 GET + 回应 / 补充凭证 / 退款凭证 / 申诉 4 写,权限集 76,路由前缀 /wxaapi/minishop/ 为历史遗留 ⇒ P3-R1 已按能力面收窄) |
Live |
AddLiveApi() |
38 | IWxaLiveRoomService(直播间本体 11:创建 / 编辑 / 删除 3 + 推流地址与分享二维码 2 走 GET + getliveinfo + 橱窗与回放与客服与评论开关 4 + 导入商品 1,权限集 52)+ IWxaLiveAssistantService(小助手 4 + 主播副号 4,小助手不等于成员角色)+ IWxaLiveRoomGoodsService(房间内商品 7:删除 / 推送 / 上下架 / 排序 / 取讲解视频 + getkey 走 GET + setkey)+ IWxaLiveGoodsService(商品库 7:add / update / audit / resetaudit / delete + getapproved 走 GET + getgoodswarehouse)+ IWxaLiveRoleService(成员角色 3)+ IWxaLiveSubscribeService(长期订阅粉丝 1 + 群发 1)。四支查询端点走 /wxa/business/ 前缀(官方历史命名),其余 34 条走 /wxaapi/broadcast/ |
Vod |
AddVodApi() |
32 | IWxaVodUploadService(上传 6:单文件与分片两条通路 + 拉取上传 + gettask 轮询,权限集 153)+ IWxaVodMediaService(媒资 4:列表 / 详情 / 播放地址 / 删除)+ IWxaVodDramaService(剧目 8:提审 / 列表 / 详情 / 提交替换 / 替换 / 改基础信息 / 查最新审核信息 + 播放器推荐位开关)+ IWxaVodCdnService(CDN 与资源包 3:用量 / 日志 / 资源包列表)+ IWxaVodAuthorizationService(授权与版权 11:剧目与版权双向授权 6 + 三视角查询 + 应用授权 2)。路由 /wxa/sec/vod/(31)+ 播放器族 /wxadrama/setplayerdramarecmdswitch(1,本域唯一非 /wxa/sec/vod/ 前缀),32 条全小写连写;authorizedrama 是全域唯一一支 GET 且带 JSON 请求体(官方调用方式与示例如此,同页错误码 43002 与之矛盾 ⇒ 裁决留档由 DV2 锁定动词) |
XPay |
AddXPayApi() |
37 | IWxaXPayCurrencyService(代币 4:currency_pay / cancel_currency_pay / present_currency / query_user_balance,其中扣减与退款扣减与查余额三支官方要求 pay_sig+signature 双签)+ IWxaXPayOrderService(订单 7:查单 / 退款 / 发货通知 / 下载单任务两支 + 账单与 iOS 月结账单下载)+ IWxaXPayGoodsService(道具 5:上传与发布各 start/query + upload_vp_file)+ IWxaXPaySubscribeService(会员订阅 4:预扣款 / 扣款 / 查签约 / 解约)+ IWxaXPayFundsService(资金与提现 10:转账账户绑定与查询 + 资金账单创建与查询 + 追缴账单 + 广告资金与广告资金下载 + 商户可提现余额 + 提现单创建与查询)+ IWxaXPayComplaintService(投诉与管控 7:列表 / 详情 / 协商历史 / 回应 / 完结 / 上传凭证签名 + query_punishment_reasons)。路由单一族 /xpay/,37 条全 POST 全小写下划线;注册委托在装载 HTTP 客户端之前先 XPaySensitiveQueryKeys.RegisterAll() 登记 pay_sig(守卫 XP6) |
OrderShipping |
AddOrderShippingApi() |
12 | IWxaOrderShippingService(发货录入与报备 4:upload_shipping_info / upload_combined_shipping_info / notify_confirm_receive / opspecialorder)+ IWxaOrderQueryService(订单与管理状态查询 4:get_order / get_order_list / is_trade_managed / is_trade_management_confirmation_completed)+ IWxaOrderSettingService(设置 2:set_msg_jump_path / setwxatradetypecgi)+ IWxaFamousBrandService(品牌申请 2:apply / get_status,权限集 142)。两族前缀 /wxa/sec/order/(10)与 /wxa/sec/famousbrand/(2),12 条全 POST;本域无方法级 [Query] 业务凭据(对照 XPay 的 pay_sig),且官方 12 页均无端点级频率数字 ⇒ 只有规模限制(守卫 OS1~OS6) |
Novel |
AddNovelApi() |
23 | IWxaNovelBookService(作品本体 6:创建 / 编辑 / 删除 / 列表 / 详情 / 审核)+ IWxaNovelChapterService(章节管理 8:上传 / 批量上传 / 删除 / 替换 / 列表 / 详情 / 重排序 / 更新 seq)+ IWxaNovelAuthService(授权管理 3:添加 / 查询 / 删除)+ IWxaNovelAccountAuthService(账号授权 3:按 appid 添加 / 查询 V2 / 删除)+ IWxaNovelReaderService(读者运营 3:设置预览配置 / 获取预览配置 / 设置推荐小说)。路由族 /wxa/book/*(20)+ /wxa/business/novelreader/*(3),23 条全 POST,权限集 169;本域零 /wxaapi/broadcast/* 路由(该族属 Live 域,NV1 负锁);官方本域无端点级频率数字 ⇒ 注释留档该空缺(守卫 NV1~NV5) |
RealName |
AddRealNameApi() |
1 | IWxaRealNameService(/intp/realname/checkrealnameinfo 校验实名信息,权限集未明确、不支持第三方代调用、官方无端点级频率数字) |
Game |
AddGameApi() |
20 | IWxaGameService 单接口(帧同步房间 4:createwxagameroom / getwxagameframe + 两支 access_info 定位的 GET)+ 用户数据存储 3(remove_user_storage / setuserinteractivedata / set_user_storage)+ 对局匹配规则 5(/wxa/business/gamematch/*)+ 米大师索要单 1(getpayfororder,官方页面标注已废弃但在册)+ 内容安全 2(/wxa/game/content_spam/*)+ 米大师 V2 游戏币 5(/wxa/game/{getbalance,pay,cancelpay,present,queryorderinfo})。出处为 minigame/dev/api-backend/ 独立文档树(2026-10-15 逐页浏览器取证);动词是 2 GET + 18 POST(五支「查询」端点官方一律 POST);路由三族 /wxa/ 直属 7 + /wxa/business/ 6 + /wxa/game/ 7,同族形态不成对(set_user_storage 带下划线、setuserinteractivedata 连写;setMatchIdOpenState→setmatchopenstate、pay_v2.queryOrder→queryorderinfo 英文名与路径不同形 ⇒ 照请求地址)。令牌面只有应用级 access_token(Query)一支:官方 20 页逐页写明不支持第三方平台调用(与 CloudBase 恰好相反)。第二重凭据 8 支:存储三支带 openid+signature+sig_method、pay_v2 五支带 signature+sig_method+pay_sig,全部是宿主计算的登录态/支付签名 ⇒ 落方法级 [Query] 而非 [Token];pay_sig 走 AddGameApi() 委托内复用 XPaySensitiveQueryKeys.RegisterAll() 登记(键集单一来源,守卫 GM6)。官方文档六处缺陷/矛盾(路径与英文名不同形、team_member_count 重复行、match_id 类型标 number、updateMatchRule 参数表疑复用、getGameFrame 请求体表重复行、getPayForOrder 废弃但在册)在接口 remarks 留档并由 GM4 锁定;端点级频率数字只有内容安全两支(文本 1 万/分钟・1000 万/天、建议超时 1s;图片 2 千/分钟・20 万/天、≤10M、建议超时 5s)(守卫 GM1~GM7) |
CloudBase |
AddCloudBaseApi() |
44 | IWxaCloudBaseEnvService(环境与账号 8:开通云开发 + 环境创建 / 查询 / 转换 / 共享 + 腾讯云凭证 getqcloudtoken 与微信令牌权限 + 手机号绑定查询)+ IWxaCloudBaseDataService(数据库与云存储 16:库/集合/索引管理 + 记录增删改查 + 文件上传下载与存储桶面)+ IWxaCloudBaseScfService(云函数 9:创建 / 更新 / 删除 / 列表 / 配置 + 层与容器面)+ IWxaCloudBaseMiscService(其它能力 11:回调配置 / 短信任务 / 统计 / cloudID / 微信支付配置 / 开放数据)。/tcb/* 42 + /wxa/getopendata + /wxa/getvoipsign(后两支为清单路由错配的纠正),44 条全 POST;路由官方页面分布在两棵文档树(miniprogram/dev/server/API/cloudbase/* 与 doc/oplatform/openApi/cloudbase-common/* + cloudbase-batch/*)但同一套 /tcb/ 路由;权限集 49(/tcb/wxpaylist 与 /tcb/wxpayopenauth 为 49、102,/wxa/getopendata 为 18、49,/wxa/getvoipsign 为 18),44 端点全部支持第三方代商家调用(令牌仍走小程序 access_token);唯一端点级频率数字是 /tcb/getqcloudtoken 的 10 次每小时。敏感面:secretid/secretkey/token、codesecret、COS 直传 authorization/签名 headers、含环境变量的 config、用户开放数据明文 ⇒ 禁入日志与异常消息(守卫 TCB6/TCB7)。/componenttcb/*(仅 component_access_token)归开放平台线,本线零声明(守卫 CBZ1 九条下架/错配 + CBZ2 两线不交叉);另有两套线字段格式并存(微信侧 snake_case 与腾讯云透传侧 PascalCase,守卫 TCB5) |
ShopAccount |
AddShopAccountApi() |
16 | 交易组件 V2 商店账号域,七接口共用注册组:IWxaShopAccountService(账号与信息 4)+ IWxaShopAuditService(审核 4:品牌 / 类目 / 小程序证书 / 审核结果,返回成功 ≠ 生效)+ IWxaShopCategoryService(/shop/cat/get,官方页文件名拼作 cateogry)+ IWxaShopImageService(/shop/img/upload)+ IWxaShopPromoterService(推客列表)+ IWxaShopRegisterService(入驻准入 4:apply 与 apply_scene 同一官方页但请求体不同,各自建模)+ IWxaShopSceneService(场景校验)。路由族 /shop/account/*、/shop/audit/*、/shop/register/* 等(V2) |
ShopFunds |
AddShopFundsApi() |
9 | 交易组件 V2 资金域,三接口共用注册组:IWxaShopFundsAccountService(余额与银行账户 3)+ IWxaShopFundsFlowService(订单流水 3)+ IWxaShopFundsWithdrawService(提现 3)。路由族 /shop/funds/*(提现三支与扫码两支位于 ministore/wxafunds/ 分区)。个人金融信息:银行卡号 / 开户名 / 提现金额 / 结算流水禁入日志与异常消息 |
ShopSharer |
AddShopSharerApi() |
8 | IWxaShopSharerService(分享员绑定 / 解绑 / 列表 / 统计 / 分享模式等,路由族 /shop/sharer/*,全部 POST)。绑定与解绑为异步终态(终态由回调推送);set_share_mode 官方参数表写 sharer_mode、示例写 share_mode ⇒ 取示例键并由守卫负锁;切换模式 2 后停止全族统计、30 天冷却(1310005) |
ShopSpu |
AddShopSpuApi() |
9 | IWxaShopSpuService(V2 商品:/shop/spu/add|del|get|get_list|update|update_without_audit 等,全部 POST)。与 V1 商品域(ProductCatalog / ProductSku 的 /product/*)是两代契约,不得互引类型或路由;审核类端点返回成功 ≠ 生效 |
ShopCoupon |
AddShopCouponApi() |
11 | 交易组件 V2 优惠券域,两接口共用注册组:IWxaShopCouponService(商家券 8)+ IWxaShopUserCouponService(用户券 3)。路由族 /shop/coupon/*、/shop/user_coupon/*;券面额与门槛单位为分、discount_num 为折扣千分比;库存与状态由官方异步结算 |
ProductCatalog |
AddProductCatalogApi() |
22 | 基础交易工具(原标准版交易组件 V1)商品域,八接口共用注册组:IWxaProductCatalogService(商品本体与分类 5)+ IWxaProductDeliveryService / IWxaProductFreightService(配送与运费 4)+ IWxaProductOfflineService / IWxaProductStoreService(线下与门店 3)+ IWxaProductRegisterService(售后与保障 3)+ IWxaProductServiceMarketService / IWxaProductShipMethodService(服务市场与物流方式等 7)。路由族 /product/*(官方 minishopopencomponent/API 分区),与 V2 /shop/* 两代不互引 |
ProductFunds |
AddProductFundsApi() |
7 | IWxaProductFundsService(V1 资金:结算账户 / 提现 / 流水,路由族 /product/funds/*)。金额单位分;结算账户与提现流水禁入日志与异常消息 |
ShopOrder |
AddShopOrderApi() |
20 | 交易组件 V2 订单域,四接口共用注册组:IWxaShopOrderService(订单 8)+ IWxaShopDeliveryService(发货 3,含官方文件名拼作 recieve.html 而正文请求地址为 /shop/delivery/receive 的纠正)+ IWxaShopPayService(支付 6)+ IWxaShopWxPayService(微信支付进件 3)。状态机 10/11/20/21/30/100/181/200/250;fund_type = 1(二级商户单)才允许取支付参数 |
ProductSku |
AddProductSkuApi() |
17 | 基础交易工具 V1 SKU 域,三接口共用注册组:IWxaProductSkuService(SKU 7)+ IWxaProductSpuService(SPU 8)+ IWxaProductStockService(库存 2)。路由族 /product/sku/*、/product/spu/*、/product/stock/*;market_price 必须严格大于 sale_price(9401055);库存全量覆盖幂等、增量更新不幂等 |
ShopAfterSale |
AddShopAfterSaleApi() |
18 | 售后域,三接口共用注册组:IWxaShopAftersaleService(V1 售后 4:/shop/aftersale/*,out_aftersale_id + refund + 状态 0~19)+ IWxaShopComplaintService(交易纠纷 3:/shop/complaint/*,只读 + 补材料,官方未发布枚举值 ⇒ 只建模 int)+ IWxaEcAftersaleService(V2 售后 11:/shop/ecaftersale/*,aftersale_id + orderamt + 状态 1~25)。两代字段与枚举不得互抄;openid / 手机号 / 退货地址 / 运单号 / 退款 ID 禁入日志 |
ProductOrder |
AddProductOrderApi() |
14 | 基础交易工具 V1 订单与地址域,两接口共用注册组:IWxaProductAddressService(地址 4)+ IWxaProductOrderService(订单 10)。路由族 /product/address/*、/product/order/*;状态值域与时间格式均与 V2 ShopOrder 不同;售后三支的 order_id 是售后单号(官方反直觉点);两页 URL 互换留档 |
ProductCoupon |
AddProductCouponApi() |
10 | 基础交易工具 V1 优惠券与限时抢购域,两接口共用注册组:IWxaProductCouponService(优惠券 7)+ IWxaProductLimitedDiscountService(限时抢购 3)。路由族 /product/coupon/*、/product/limiteddiscount/*;读写两侧时间与枚举异型;官方两页 valid_type 冲突(create 1/2、update 0/1)留档 |
ProductMedia |
AddProductMediaApi() |
10 | 基础交易工具 V1 装修与素材域,三接口共用注册组:IWxaProductDecorationService(装修服务 6,启停两段式:decoration_service 返回成功仅表示已下发确认,生效须轮询 check_status)+ IWxaProductImageService(图片上传 1:upload_type=0 multipart / =1 JSON 双形态)+ IWxaProductQrCodeService(管理二维码 3,图片为 base64)。/product/img/upload 双形态共路由按 1 条计 |
Midas |
AddMidasApi() |
8 | IWxaMidasService(小游戏米大师虚拟支付:正式环境 4 + 沙箱环境 4;路由族 /cgi-bin/midas/*、/cgi-bin/midas/sandbox/*)。只承载 HTTPS 调用面;sig 由调用方按 HMAC-SHA256 计算后透传,SDK 不代算、密钥与签名原文禁入日志;幂等依赖 bill_no |
CityService |
AddCityServiceApi() |
5 | 城市服务域,两接口共用注册组:IWxaCityServiceElderMedicalService(适老化医疗 2:getmedrealname 等)+ IWxaCityServiceBasicService(基础能力 3:getservicepath / sendchannelmsg / sendmsgdata)。路由族 /cityservice/*;人脸核身三端点不落地(官方无现行页)由零声明守卫锁定;open_id、医保授权码、密文姓名禁入日志 |
BusinessCapability |
AddBusinessCapabilityApi() |
5 | 行业能力域,两接口共用注册组:IWxaBusinessRetailService(B2b 门店助手 3:batchcreateretail / getretailinfo / retailnotifybusiness)+ IWxaBusinessRuntimeService(WMPF 硬件框架 2:runtime/adddevice / runtime/pushappmsg)。B2b 族用小程序 access_token,WMPF adddevice 须用移动应用(LauncherAPP)令牌(官方原文,宿主保证);/wxa/business/applyliveinfo 归开放平台线、本线零声明;手机号 / 统一社会信用代码 / 法人姓名 / push_token 禁入日志 |
三个模块级方法之外还有 AddAllApis()、AddModules(params MiniProgramModule[]) 与 Build()(返回 IServiceCollection)。
用法
// 凭据与公众号共用同一配置节(AppId / AppSecret),令牌底座由公众号包提供
builder.Services.AddMpApp(builder.Configuration, "MpApps")
.AddMiniProgramServices(b => b.AddAllApis());
// 换会话走 appid + js_code,**方法级 [Token(Disabled = true)] 免令牌**(A-7 合并后随 IWxaAuthService 承载;
// 声明接口级 [Token] 反而会把应用级令牌注入免令牌端点,语义错误)
var session = await auth.Code2SessionAsync(appId, appSecret, jsCode, ct); // session_key 不入日志(MP-X7)
var trend = await dataAnalysis.GetDailyVisitTrendAsync(request, ct);
using var code = await wxaCode.GetUnlimitedCodeAsync(request, ct); // 图片流,须释放
小程序线没有回调工程:消息与事件接收属公众号 XML 通道(Mud.Wechat.OfficialAccount.Callback),本线的 MiniProgramScaffoldContractGuards 锁定「无 Callback 程序集」这一形态,防止「顺手补一个」造成两条线各自解析同一信封。
小程序码的二进制通道(本包手写通道之一)
getwxacode / getwxacodeunlimit / createwxaqrcode 三端点成功时返回图片字节流、失败时才返回 JSON,无法进 [HttpClientApi] 生成管线(管线按 JSON 反序列化)。故:
- 接口
IWxaCodeService(Interfaces/QrCodeLink/)+ 手写实现WxaCodeService(QrCodeLink/,非Internal/)。 - 返回
WxaCodeResult : IDisposable(ContentType/FileName/Content/Response),调用方须释放(内部持有HttpResponseMessage)。 - 判错按
Content-Type分支:命中json才解析errcode,非零即抛WxaException(errcode, errmsg, path);application/json之外的响应一律当图片处理。 - 三条路由以路径常量形式存在(不在 HTTP 特性上),因此 MP-X1 的路由重复校验须把它们单独并入参照集,否则会出现「反射口径失效 ⇒ 静默假绿」。
落位与形态约束
- 平铺命名空间、无
IsAbstract父接口(MP-X4):本线接口全部落Mud.Wechat.MiniProgram,不复制企业微信线「父接口 / 子接口分面」形态——三模式差异在小程序侧不存在。 - 字段名照官方原文(MP-X5):
session_key/js_code/trace_id/page_url等不得驼峰化。 [Token].Name恒为access_token(MP-X3),注入走 Query(微信公众平台契约)。- 即时配送返回体不是
errcode/errmsg(2026-10-12 逐页核验):/cgi-bin/express/local/*全族官方用resultcode/resultmsg表达运力侧结果,故该族响应统一继承WxaExpressLocalResponse(在WxaResponse之上补齐两字段),判错以resultcode == 0为准。另:该族官方字段名拼写在各页间不一致(下单页insurancfee/ 预下单页insurancefee、下单页couponfee/ 预下单页couponFee),照各页原文承载,勿跨页统一。 - 直播域官方拼写在页间不一致(2026-10-13 逐页取证,照各页原文承载,勿跨页统一):房间定位键同域四形态 ——
roomId(broadcast 写侧)、room_id(/wxa/business/侧与订阅群发)、roomid(getliveinfo应答连写)、id(editroom/deleteroom/updatecomment);商品键goodsId写侧为 number、getapproved应答为 string、getgoodswarehouse应答为 snake_case 的goods_id;路由侧同族大小写混排(getapproved全小写 vsgetVideo/deleteInRoom驼峰)。另:addassistant写入用username而getassistantlist应答用alias,getkey请求为goodsKey而应答为vendorGoodsKey。 - 短剧媒资域官方自相矛盾与同族异名(2026-10-13 逐页取证,照官方示例与页间原文承载,勿跨页统一):
authorizedrama参数表列被授权方为authorized、同页示例为authorized_appid⇒ 采信示例(域内其余 12 处被授权方字段名一律authorized_appid);到期键两侧不同源——剧目侧authz_expire_time、版权侧expire_time;两视角查询端点getauthorizedobjects(过去式,应答含authorizer_appid)与getauthorizeobjects(原形,应答含authorized_appid)官方并存不得归一,而「查已授权小程序列表」官方是getauthorizeapps(无authorized形态);同名drama_id在授权写侧是数组、查询侧是单值;file_size官方类型列为 string、data_interval表列 string 而示例为数字(按示例取 number);task_info与result[]内层的errcode/errmsg是任务级/逐剧目级结果码,外层WxaResponse兜不住 ⇒ 两类型各自承载。另:媒资审核状态与剧目审核状态取值集同为 0~4 但 2 的语义不同 ⇒ 两套常量类分立。 - 短剧媒资敏感值:
getcdnlogs返回的日志含客户端 IP、getmedia/getmedialink返回的mp4_url/hls_url是带签名的临时播放地址 ⇒ 与permanent_code同级别处置,禁止写入日志、遥测或异常消息。 - 虚拟支付的
pay_sig/signature不是令牌(MP-B4):两支都是宿主自行计算的支付签名(pay_sig按官方 HMAC 口径、signature为用户态签名),因此落方法级[Query]参数由调用方传入,不得做成[Token]声明([Token]只会注入access_token,语义错误且会污染令牌面)。域内令牌绑定仍是Wechat.Mp.AccessToken+ Query 注入(MP-X2/X3)。 pay_sig必须靠登记而非词表:组件SensitiveUrlRedactor是精确匹配词表,sig/sign/signature三支都覆盖不到pay_sig⇒AddXPayApi()**与AddGameApi()(米大师 V2 五支同用pay_sig)**的注册委托都先XPaySensitiveQueryKeys.RegisterAll()再装载客户端(AGENTS §8「补词表 / 登记豁免」二选一取登记一支;两模块共用同一登记面,键集单一来源,不建第二张表);组件词表一旦收录pay_sig,守卫 XP6 的自过期闸先红,须同批从All移除。- 只注册 Game 不注册 XPay 的宿主同样要有掩码:登记发生在模块注册委托内(不在
Build()里无条件执行,副作用只随使用的模块发生)⇒ 若 Game 委托写成裸s.AddGameWebApiHttpClient(),pay_sig会随ApiException.RequestUri明文外泄。守卫 GM6 以「委托体文本(先登记后装载)+ 真实装配路径的运行期掩码」双向锁定:单靠运行期断言在 XP6 先跑的进程里会假绿。 - 小游戏米大师 V2 的签名基串口径(GM3 相关,宿主侧最易错):
signature = hex(hmac_sha256(session_key, post_body))、pay_sig = hex(hmac_sha256(app_key, uri + '&' + post_body)),其中uri必须舍去?及之后部分、post_body须与实际发出的请求体逐字节一致(补一个空格即90010/90011);sig_method官方唯一取值hmac_sha256(是算法名而非凭据,脱敏时保留原文以利排障)。SDK 侧不计算、不缓存签名。 env四档语义(2026-10-13 逐页取证,勿跨页统一):17 支只在沙箱做签名校验、13 支两档通用、submit_subscribe_pay_order只接受生产档(传沙箱值报-15011)、6 支正文根本没有env字段。四档由 XP3 以「两两不交叉 + 并集 = 37」锁定,且与 DTO 面机械耦合——6 支无env端点的请求体不得出现Env属性。- 错误码表三档:28 支共用域内
26849_0xx码表、send_subscribe_pre_payment与submit_subscribe_pay_order各有独立码表(前者674690001/690000000/690000001,后者为米大师侧-15001 ~ -15027加1001⇒ 判错不得套域内表)、7 支官方明写「此接口没有特殊错误码」。query_download_order与cancel_subscribe_contract属最后一档而非共用档 ⇒ XP3 钉住。 - 虚拟支付域官方拼写缺陷(照原文承载,「顺手修正」即与线上报文对不上):路由
bind_transfer_accout(少一个 n,XP1 反向钉住bind_transfer_account不得出现);协商操作类型取值USER_COMFIRM_COMPLAINT(少 r)、MERCHANT_REFUSE_RERUND(少 f),常量名按正确语义命名、值照官方原文(XP5 锁定)。 - 虚拟支付敏感值:代币余额、商户可提现余额、提现金额、账单/订单下载链接(
url/bill_url/download_url)、cos_url(官方明示 30 分钟有效)、sign、pay_sig、signature、订单token、投诉人payer_phone/payer_openid⇒ 与permanent_code同级处置,禁止写入日志、遥测或异常消息。 - 发货域「录入侧 / 查询侧」字段名不同源(2026-10-13 逐页取证,照各页原文承载,勿跨页统一):定位订单的键在录入侧是
order_key(内含mchid/out_trade_no/order_number_type/transaction_id),在查询侧是扁平的merchant_id/sub_merchant_id/merchant_trade_no⇒ 两套 DTO 分立、不得合并;发货时间顶层upload_time录入侧是字符串、查询侧记录内是long?时间戳;商品描述录入侧item_desc、查询侧goods_desc。两支is_trade_*共用同一请求体,但应答键一个is_trade_managed、一个completed。 - 品牌申请的两支形态特例:
apply的包装键是首字母大写的Application(官方原文如此,域内其余键全小写下划线);get_status官方请求参数表零字段 ⇒ 无[Body]参数(OS3 锁定,补一个空请求体即与官方报文对不上)。 - 发货域官方拼写缺陷(照原文承载,「顺手修正」即 404):交易类型变更申请的路由是
setwxatradetypecgi(连写且尾部带cgi,OS1 反向钉住set_wxa_trade_type不得出现);特殊发货报备是opspecialorder(连写);设置消息跳转路径的官方正文标题为setMsgJumPpath(大小写错拼),路由仍照set_msg_jump_path。 - 发货录入端点全部非幂等(「一次机会」):
upload_shipping_info/upload_combined_shipping_info/notify_confirm_receive/opspecialorder官方语义为一次性上报,重复上报即报错 ⇒ 不得为「重试友好」而自动重试或吞重复码;本域官方 12 页均无端点级频率数字,只有规模限制(合单子单数、列表分页上限等)。 - 发货域敏感值:
openid、paid_amount(单位分)、contact.consignor_contact/receiver_contact(官方要求掩码传输,且明示最后 4 位数字不得打掩码)⇒ 与permanent_code同级处置,禁止写入日志、遥测或异常消息。本域无新增 Query 凭据(只有access_token,已在组件词表内)⇒ 不动SensitiveUrlKeys、不进 QT1 词表豁免。 - SSRF 白名单零改动(MP-X8):沿用
api.weixin.qq.com,本线不得增删AllowedBaseUrlDomains、不得自行调用ConfigureAllowedDomains。
依赖
Mud.Wechat.Abstractions(叶层)+ Mud.Wechat.MiniProgram.Abstractions + Mud.Wechat.MiniProgram.DataModels + Mud.HttpUtils 3.0.9(.Attributes / .Generator 3.0.9,Generator 仅分析器)。跨线只允许一条边——Mud.Wechat.OfficialAccount.Abstractions(取令牌 / 多应用基座):禁止引用公众号主包 / DataModels / Callback(MP-X1 / MP-X5)。序列化上下文由 MiniProgramJsonResolverExtensions 合并进组件管线(47 个 Generated/*JsonContext,「登记进上下文」与「合并进数组」的一致性由 XP5 断言锁定)。
目标框架继承根 Directory.Build.props(netstandard2.0;net6.0;net8.0;net10.0、Version 1.2.0),可打包。
守卫
Tests/Mud.Wechat.MiniProgram.Tests/ContractGuards/:MiniProgramContractGuards(MP-X1/X2/X3/X5/X6/X7/X8/X9 契约类断言)、MiniProgramScaffoldContractGuards(形态类断言:令牌复用 / 无父接口 / 重叠路由 / 依赖隔离 / 无回调包)、MiniProgramP3RulingsContractGuards(P3 长尾四条裁决;minishop 与 broadcast 两条已按能力面收窄为清单式在册——前者店铺 / 商品管理面零声明、官方 2026-10-13 仍在小程序目录在册的投诉处理 5 条以白名单 + 清单断言锁定;后者于 2026-10-13 解除「直播不实现」裁决(依据:官方 38 页服务端 API 逐页在册,停止接入的是前端「直播插件」组件页),broadcast 前缀 34 条以六个接口文件豁免 + 清单等式锁定,白名单外文件命中前缀即红)、WxaVipContractGuards(MPV 系列:Vip 域 6 端点路由 / 令牌绑定 / 空请求体端点规则 / DTO 登记计数与 JSON 上下文)、WxaTransactionGuaranteeContractGuards(TG1~TG5:16 端点路由表与三个前缀 / GET-Query 与 POST-Body 形态(GET 端点零 [Body])/ 三接口共组 TransactionGuarantee 注册组与令牌绑定 / 41 DTO 上下文登记与命名空间清单 / 官方字段名与类型口径 + 两处共用 DTO 裁决)、WxaLiveContractGuards(LB1~LB5:38 端点路由表与两个前缀 + 同族大小写混排拼写锁 + 四支 /wxa/business/ 端点清单 + 错误拼写 broadcast/getgoodswarehouse 的反向钉住 / GET-Query 与 POST-Body 形态(7 GET 端点零 [Body],含 getkey 无业务参数)/ 六接口共组 Live 注册组与令牌绑定 + 六接口方法数之和与路由表一致自证 / 53 DTO 上下文登记与命名空间清单(六个枚举常量类放行)/ 官方字段名与类型口径 + 五处共用 DTO 裁决 + editroom 不得凭空补副号字段)、WxaVodContractGuards(DV1~DV5:32 端点路由表与 /wxa/sec/vod/ 族前缀(31)+ 播放器族 /wxadrama/setplayerdramarecmdswitch 例外(1) + 全小写连写与单复数(submitreplacedramamedias vs replacedramamedia)+ 两视角 getauthorizedobjects / getauthorizeobjects 并存 + 错误拼写 getauthorizedapps 的反向钉住 / 参数形态(全域零 [Query]、29 支单 [Body]、2 支 multipart、getauthorizeapps 零业务参数,且 GET+Body 只允许 authorizedrama 一支)/ 五接口共组 Vod 注册组与令牌绑定 + 逐接口方法数与总数自证 / 69 DTO 上下文登记与命名空间清单(21 个枚举常量类放行)+ 21 应答与端点返回类型一一对应 + 21 枚举取值集 / 官方字段名与类型口径 + 七处共用 DTO 裁决 + authorized→authorized_appid 改名裁决)、WxaXPayContractGuards(XP1~XP6:37 端点路由表与单一 /xpay/ 族前缀 + 全 POST 全小写下划线 + bind_transfer_accout 官方错拼的反向钉住 + 下载单两支与账单下载的三形态区分 / 令牌绑定与 XPay 共组注册组 + 逐接口方法数之和与路由表一致自证 + pay_sig 28 支与 signature 必传 3 支可选 2 支的参数面与 IsOptional 口径 / env 四档与错误码三档的「两两不交叉 + 并集 = 37」及 env 与 DTO Env 属性的机械耦合 / /xpay/ 路由仅在小程序线声明(跨线零声明,两支正对照防真空)/ 83 DTO 上下文登记与命名空间清单(5 枚举常量类放行)+ 27 应答与端点返回类型一一对应 + 主包合并数组与程序集上下文一一对应 + 官方字段名与类型口径与共用 DTO 裁决 + 两处官方错拼取值 / pay_sig 走登记不走词表的四道闸:自过期、词表交叉、孤儿键、真实装配路径下的运行期掩码功能断言)、WxaOrderShippingContractGuards(OS1~OS6:12 端点路由表与两个族前缀 /wxa/sec/order/(10)+ /wxa/sec/famousbrand/(2)+ 全 POST 全小写下划线 + setwxatradetypecgi / opspecialorder 官方连写的反向钉住(set_wxa_trade_type 不得出现)+ 两支发货录入端点不得合并 / 参数形态(11 支恰一个 [Body]、get_status 零 [Body] 零业务参数、全域零方法级 [Query]——本域无 pay_sig 类第二重凭据,故不进 QT1 词表豁免)/ 四接口共组 OrderShipping 注册组与令牌绑定 + 逐接口方法数 4/4/2/2 与路由表一致自证 / 官方字段名与类型口径(order_key 与 merchant_id 两套定位键分立、upload_time 两侧一 string 一 long?、item_desc vs goods_desc、Application 大写包装键、两支 is_trade_* 共用请求体而异名应答、合单顶层无发货三字段)+ 14 次逐行 JSON 名集锁定 + 敏感值抽样 / 30 DTO 上下文登记与命名空间清单(10 常量类放行)+ 十张官方取值表逐表锁定 + 5 应答与端点返回类型一一对应 + 7 支空回体直接用 WxaResponse + 主包合并数组与程序集上下文一一对应 / 开放面矩阵(云调用 7 支持 ⊍ 5 不支持、第三方 10 ⊍ 2 不支持、权限集 18+142)+ 错误码四档「两两不交 + 并集 = 12」+ 官方 12 页无频率数字的空缺留档 + setMsgJumPpath 错拼留档)、WxaCloudBaseContractGuards(TCB1~TCB7 + CBZ1/CBZ2:44 端点路由表与 /tcb/ 恰 42 支 + /wxa/getopendata / /wxa/getvoipsign 两支错配纠正 / 参数形态(4 支空体端点、[Query] 名集合 ⊆ {openid})/ 令牌绑定与四接口共组 CloudBase 注册组 / 98 DTO 上下文登记与命名空间清单 / 两套线字段格式并存(微信侧 snake_case 与腾讯云透传侧 PascalCase)+ 五支官方错拼钉住(getFuntionLink / getFuntionList / getFuntionConfig / getUploadFuntionConfig / getYploadSignature)/ 敏感值不入日志(判定要求真实调用形态并剥行内注释,防空跑与假红双向)与敏感 DTO 不重写 ToString / 九条零声明(裸发短信 2 + 压测 3 + 即将下架配置 2 + 清单错配 2)+ /componenttcb/ 归开放平台线的小程序侧零声明)、WxaGameContractGuards(GM1~GM7:20 端点路由表与三族前缀(/wxa/ 直属 7 + /wxa/business/ 6 + /wxa/game/ 7)+ 2 GET + 18 POST 的动词分布 + 同族形态不成对(set_user_storage 下划线 vs setuserinteractivedata 连写)+ 两支「英文名≠请求地址」的正向钉住与按英文名拼路径的反向钉住(setmatchidopenstate / queryorder 不得出现)/ 令牌绑定与 Game 注册组 + 接口级单 [Token](官方 20 页逐页写明不支持第三方代调用 ⇒ 不得声明第二支)+ 方法数与路由表一致自证 / 凭据参数面逐端点锁定:2 支 access_info、3 支 openid+signature+sig_method、5 支 signature+sig_method+pay_sig,其余 10 支零 [Query];三支清单两两不交且并集 == 「接口面上真的带 Query 的端点」全集,签名参数一律必填(IsOptional 为 false)/ 官方文档六处缺陷与三处共用类型裁决的留档面(用接口源码文本兜住注释丢失)+ 字段名与类型抽样(单数 key、match_id 取 string、need_room_service_info 纠正官方重复行、payfororder 全小写、b / dp_id 原文保留、set_user_storage 的 value 取 JsonElement? 而互动数据那支取 long?)/ 46 DTO 上下文登记与命名空间清单(本域无常量类 ⇒ 域内类型须全为 DTO)+ 主包合并数组与程序集上下文一一对应 / AddGameApi() 委托必须先 XPaySensitiveQueryKeys.RegisterAll() 再装载(委托体文本 + 运行期掩码双向锁定:纯运行期断言在 XP6 先跑的情况下会假绿)+ sig_method 保留原文(算法名非凭据)/ 20 条路由跨线零声明 + 敏感值不入日志(真实调用形态、剥行内注释,防空跑与假红双向))、MiniProgramNonContractRouteContractGuards(NC1~NC3:清单 D 桶 86 条的归属终判——25 条非契约在全仓 Src/ 零声明、35 条开放平台令牌面路由与 6 条线外路由(Donut / 公众号门店;原含「小游戏 20 条」,2026-10-15 P1-8 收口批解除该裁决并按取证落位本线 Game 域)在小程序线零声明;三档共用同一趟剥注释声明扫描并以已落位路由作正对照,判据与逐条证据见 .docs/MudWechat-小程序D桶归属终判留档-2026-10-13.md)。
2026-10-18 交易组件波次(224 条工作单)新增守卫:WxaShopV2ContractGuards(V2 /shop/* 五域 74 端点路由 / 17 支接口 / 注册组与令牌 / DTO 上下文计数 / 官方拼写负锁)、WxaProductV1ContractGuards(V1 /product/* 六域 74 端点 / 嵌套业务对象与端点信封的应答基类判定 / 路由字面量跨线扫描)、WxaShopFundsContractGuards、WxaProductFundsContractGuards、WxaShopSharerContractGuards(资金与分享员小域路由表 / 敏感字段不入日志 / DTO 登记)、WxaMidasCityServiceBusinessContractGuards(米大师 8 + 城市服务 5 + 行业能力 5:路由 / 令牌 / 注册组 / 字段名与类型 / 零声明四条非契约路由 + OpenPlatform 归属正对照)、WxaLeaguePromoterContractGuards 与 WxaLeagueShopContractGuards(/union/promoter/* 22 条与 /union/shop/* 10 条逐页 301 判非契约:零接口 / 零 DTO / 零注册组,继任面 /channels/ec/league/* 与 /channels/ec/promoter/* 归小店线)。合计增量 189 端点(398 → 587),零声明 14 条(联盟 32 + 城市服务人脸核身 3 + applyliveinfo 1,后两者另由跨线/零声明守卫覆盖)。
原 Mud.Wechat.MiniProgram.Abstractions 包面(2026-10 包合并并入本工程,命名空间不变)
微信小程序 SDK 抽象包:官方错误码常量与线级异常类型。体量刻意极小——小程序与公众号同属微信公众平台,令牌、多应用基座与配置面全部复用 Mud.Wechat.OfficialAccount.Abstractions,本包不重复实现任何一处。
内容
WxaErrorCodes——官方错误码常量 13 个(含Success = 0)。字段名与数值照官方原文,判定器与本集合同源,避免「散落的魔法数字」。WxaException : WechatApiException——小程序线统一异常(ErrorCode= 官方errcode;构造期经基座剥离 Query 与 userinfo,不泄露令牌)。含静态入口ThrowIfFailed<TResponse>(TResponse?, string? requestUri),约束where TResponse : class, IWechatApiResponse⇒ 与公众号 / 企业微信线共用同一叶层判错契约。
本包不提供配置类型:小程序应用凭据即公众号凭据(MpAppConfig:AppId / AppSecret / UseStableToken,默认节 MpApps、UseStableToken 默认 true)。新增「小程序专属配置面」会造成同一 AppId 两处注册、两套令牌缓存,属被否决形态。
为什么令牌不落在本包(关键裁决)
公众号侧 MpTokenManagerRegistry 是 internal sealed、按 MpTokenTypes.AccessToken 单槽键控。若小程序线新增一个令牌类型(如 Wechat.Wxa.AccessToken),注册表读不到该槽 ⇒ errcode 令牌恢复返回 null、静默空转且不抛异常——这是最危险的一类漂移(编译通过、运行期只表现为「令牌过期后不自愈」)。因此 MP-X2 把「复用令牌类型」锁成守卫,MP-X3 进一步锁死 [Token].Name 恒为官方 access_token。
同理,本线接口为平铺命名空间、无 IsAbstract 父接口(MP-X4):三模式(自建 / 第三方 / 代开发)差异在小程序侧不存在,父/子分面只会凭空造出一层无用抽象。
依赖
Mud.Wechat.Abstractions(叶层)+ Mud.Wechat.MiniProgram.DataModels + Mud.Wechat.OfficialAccount.Abstractions(跨线唯一允许的边)+ Mud.HttpUtils 3.0.9(.Generator 3.0.9 仅分析器,PrivateAssets=all)。
禁止引用公众号主包 / DataModels / Callback(MP-X1 / MP-X5 守卫锁定)。Mud.HttpUtils 与 .Generator 版本须全仓单一(通用守卫 G1,NU1605 视为错误)。
目标框架继承根 Directory.Build.props(netstandard2.0;net6.0;net8.0;net10.0、Version 1.0.3),可打包。
已踩陷阱
netstandard2.0下无IsExternalInitpolyfill ⇒ 本线公共类型不用init/record/with。- 免令牌端点(
sns/jscode2session)不得声明[Token]:生成器仍要求显式TokenManage = nameof(IMpAppManager)(HTTPCLIENT018),但[Token]一旦声明就会把应用级令牌注入该请求,语义即错。
原 Mud.Wechat.MiniProgram.DataModels 包面(2026-10 包合并并入本工程,命名空间不变)
微信小程序 SDK 数据模型包(纯 DTO):官方接口出入参与 AOT 源生成序列化上下文,独立交付以便宿主不引入运行时依赖。
内容
798 个标注
[HttpJsonSerializable(SerializerClassName = "<域段>")]的类型,按域目录与接口域一一对应,命名空间恒为Mud.Wechat.MiniProgram.DataModels.{域}(RequestModel/、ResponseModel/之类仅作组织,不入命名空间)。域清单:Auth12 /Common1 /DataAnalysis17 /QrCodeLink20 /Security8 /SubscribeMessage7 /DynamicMessage6 /Kf10 /HardwareDevice14 /Operation14 /Plugin6 /Charge4 /NearbyPoi8 /Search5 /Soter2 /ServiceMarket4 /RedPacketCover3 /Student2 /FaceVerify5 /LaborUse2 /Express165 /Vip11 /TransactionGuarantee41 /Live53 /Vod69 /XPay83 /OrderShipping30 /Novel50 /RealName2 /Game46 /CloudBase98。统一响应基底
WxaResponse(根命名空间直属 ⇒ 归Common组)实现叶层判错契约IWechatApiResponse(ErrorCode/ErrorMessage/IsSuccess),使WxaException.ThrowIfFailed与其余两条线共用单点判定。与公众号
MpResponse同形但不共用(本仓既定形态,两条理由):① 硬边界——小程序线不得引用公众号 DataModels(只允许引用其 Abstractions 的令牌 / 多应用基座,MP-X1 / MP-X5 锁定);②JsonSerializerContext按程序集生成,跨程序集复用 DTO 会让序列化元数据落错上下文。成功响应可能整体缺省
errcode(官方多页如此)⇒ErrorCode缺省即0、IsSuccess为真,不得把「字段缺失」判成失败。官方 DTO 按域落
DataModels/{域}/(2026-10 源码归类把原散在工程根的 DTO 域目录连同Generated/收拢于此;只动目录、命名空间仍为Mud.Wechat.MiniProgram.DataModels.{域}[.{子域}]不变;该「目录 ⇔ 命名空间」双向不变式由 AB-G10 守卫锁定)。DataModels/Generated/:47 个上下文文件(每域一个,含AuthJsonContext/CommonJsonContext/DataAnalysisJsonContext/QrCodeLinkJsonContext/SecurityJsonContext/ExpressJsonContext/VipJsonContext/TransactionGuaranteeJsonContext/LiveJsonContext/VodJsonContext/XPayJsonContext/OrderShippingJsonContext/NovelJsonContext/RealNameJsonContext/GameJsonContext/CloudBaseJsonContext等),由scripts/GenerateJsonContext.ps1生成,<auto-generated>头、勿手改、须随 DTO 变更同批提交。
用法(JsonContext 生成流程)
新增 / 变更 DTO 后按序执行(脚本默认参数指向 Work 线,本线必须显式覆盖):
# 1) 补标注:SerializerClassName 取命名空间域段(根命名空间直属文件归 Common)
./scripts/AddHttpJsonSerializable.ps1 `
-RootPath Src/MiniProgram/Mud.Wechat.MiniProgram/DataModels `
-RootNamespace Mud.Wechat.MiniProgram.DataModels
# 2) 重生成上下文:按分组发射 DataModels/Generated/{组}JsonContext.g.cs
./scripts/GenerateJsonContext.ps1 `
-TargetProject Src/MiniProgram/Mud.Wechat.MiniProgram/Mud.Wechat.MiniProgram.csproj `
-OutputDir Src/MiniProgram/Mud.Wechat.MiniProgram/DataModels/Generated
# 3) AOT 严格门禁复测
dotnet build Src/MiniProgram/Mud.Wechat.MiniProgram -c Release -f net8.0 -p:AotStrictMode=true
宿主侧无需手工串联上下文:主包 MiniProgramJsonResolverExtensions 把 31 个上下文合并进组件序列化管线(仅 net8.0+;低 TFM 走反射 STJ,AOT 门禁只对 net8.0+ 生效)。上下文为 internal,经 InternalsVisibleTo 对主包、Abstractions 与测试工程直读。「DTO 已进上下文」不等于「上下文已进合并数组」——数组在主包、上下文在本包,跨包漏接时 JIT 靠反射兜住、门禁全绿,只有 Native AOT 首次调用才炸;该一致性由守卫 XP5 以「程序集内 *JsonContext 类型集 ⇔ 合并数组里的 XxxJsonContext.Default 集」双向等价锁定。
已踩陷阱
字段名照官方原文,不得驼峰化(MP-X5 逐字段锁定,守卫点名的即
session_key/js_code/trace_id/page_url);其余如begin_date/end_date/entrypage_pv/env_version/check_path一律以[JsonPropertyName]显式对齐,官方 snake_case 的拼写不由我方「纠正」。小程序码三端点(
getwxacode/getwxacodeunlimit/createwxaqrcode)成功响应是图片二进制,不进本包的 JSON 管线 ⇒ 只有其请求 DTO(WxaCodeRequests,4 个标注类型)在此登记,响应侧由主包WxaCodeResult承载。netstandard2.0下无IsExternalInitpolyfill ⇒ DTO 用可空set,不用init/record。虚拟支付域的三处「照官方、别纠正」(MP-B4,2026-10-13 逐页取证):① 协商操作类型的线格式值自带错拼
USER_COMFIRM_COMPLAINT(少 r)/MERCHANT_REFUSE_RERUND(少 f),常量名按正确语义命名、值照原文;② 金额与时刻在官方两套表里类型不同源——query_user_balance的余额是number、query_biz_balance的amount与提现单的withdraw_amount是string、withdraw_success_timestamp是string(成功时刻可为空串),一律不得数值化「统一」;③ 缩写键照原文sett_time/req_from/begin_ds/left_fee/cos_url,投诉人 openid 是全小写payer_openid而非payer_open_id。另:6 支正文无env字段的端点,其请求 DTO 不得出现Env属性(XP3 把这一点做成机械耦合断言)。发货信息与品牌申请域的四处「照官方、别统一」(MP-B5,2026-10-13 逐页取证):① 订单定位键两侧分立——录入侧是嵌套的
order_key(mchid/out_trade_no/order_number_type/transaction_id),查询侧是扁平的merchant_id/sub_merchant_id/merchant_trade_no,报备侧又只有order_id,三套各承载各的 DTO;② 同名字段跨页异型——upload_time在录入请求是string、在查询记录是long?,商品描述录入侧item_desc、查询侧goods_desc;③ 品牌申请的包装键是官方原文的首字母大写Application(域内其余字段一律小写下划线),而get_status官方请求参数表零字段 ⇒ 无请求 DTO;④ 两支is_trade_*共用同一请求体(WxaOrderTradeManagedQueryRequest),但应答键分别是is_managed侧的is_trade_managed与completed⇒ 共用请求、不共用应答。另:Shipping/、Query/、Setting/、FamousBrand/四子目录仅作组织,命名空间恒为...DataModels.OrderShipping(OS5 逐类型锁定)。
依赖
Mud.Wechat.Abstractions(叶层,仅取 IWechatApiResponse)+ Mud.HttpUtils.Attributes 3.0.9(零依赖特性包)+ Mud.HttpUtils.Generator 3.0.9(仅分析器,PrivateAssets=all)。与 Mud.HttpUtils 主包版本须全仓单一(通用守卫 G1)。
目标框架继承根 Directory.Build.props(netstandard2.0;net6.0;net8.0;net10.0、Version 1.0.3),可打包;本包无 DI 入口、无令牌 / 客户端类型。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.Extensions.Configuration.Binder (>= 10.0.12)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Http (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Options (>= 10.0.12)
- Mud.HttpUtils (>= 3.0.9)
- Mud.HttpUtils.Attributes (>= 3.0.9)
- Mud.Wechat.Abstractions (>= 1.0.0)
- Mud.Wechat.OfficialAccount (>= 1.0.0)
- System.Text.Json (>= 10.0.12)
-
net10.0
- Microsoft.Extensions.Configuration.Binder (>= 10.0.12)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Http (>= 10.0.9)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Options (>= 10.0.12)
- Mud.HttpUtils (>= 3.0.9)
- Mud.HttpUtils.Attributes (>= 3.0.9)
- Mud.Wechat.Abstractions (>= 1.0.0)
- Mud.Wechat.OfficialAccount (>= 1.0.0)
-
net6.0
- Microsoft.Extensions.Configuration.Binder (>= 10.0.12)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Http (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Options (>= 10.0.12)
- Mud.HttpUtils (>= 3.0.9)
- Mud.HttpUtils.Attributes (>= 3.0.9)
- Mud.Wechat.Abstractions (>= 1.0.0)
- Mud.Wechat.OfficialAccount (>= 1.0.0)
-
net8.0
- Microsoft.Extensions.Configuration.Binder (>= 10.0.12)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Http (>= 10.0.9)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Options (>= 10.0.12)
- Mud.HttpUtils (>= 3.0.9)
- Mud.HttpUtils.Attributes (>= 3.0.9)
- Mud.Wechat.Abstractions (>= 1.0.0)
- Mud.Wechat.OfficialAccount (>= 1.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.0 | 128 | 10/29/2026 |