微信运营后台接口与权限索引

调用约定

• 后端控制器路径统一经网关增加 /weixin 前缀。
• 返回结构使用项目统一 R，业务数据位于 data。
• 管理接口要求登录、租户上下文和按钮权限。
• AppID 必须属于当前租户，且账号类型必须符合接口要求。
• 微信错误通过业务异常返回，页面应展示错误码和错误信息，不要改成统一“操作失败”。

例如：控制器 GET /wxapp/list?appType=1 的前端地址为 GET /weixin/wxapp/list?appType=1。

平台与统一运营接口

公众号接口

小程序接口

关键闭环接口

统一消息

• GET /wxmessagetask/accounts
• GET /wxmessagetask/page
• GET /wxmessagetask/{id}
• POST /wxmessagetask
• POST /wxmessagetask/{id}/send
• POST /wxmessagetask/{id}/cancel
• POST /wxmessagetask/{id}/retry
• POST /wxmessagetask/templates/sync/{appId}
• POST /wxmessagetask/test

授权账号与 Open Platform

• POST /wxopenauthorizer/authorization-url
• GET /wxopenauthorizer/page
• GET /wxopenauthorizer/{appId}
• POST /wxopenauthorizer/{appId}/sync
• POST /wxopenauthorizer/sync-all
• POST /wxopenauthorizer/reconcile
• POST /wxopenauthorizer/{appId}/access-token/refresh
• GET/POST /wxopenauthorizer/{appId}/open-account
• POST /wxopenauthorizer/{appId}/open-account/bind
• DELETE /wxopenauthorizer/{appId}/open-account/{openAppId}

第三方平台模板与域名

• GET /wxcodetemplate/drafts
• GET /wxcodetemplate/templates
• POST /wxcodetemplate/templates
• DELETE /wxcodetemplate/templates/{templateId}
• GET/POST /wxopendomain/server
• GET/POST /wxopendomain/business
• GET /wxopendomain/confirm-file

物流助手

• GET /wxmaexpress/apps
• GET /wxmaexpress/{appId}/deliveries
• GET /wxmaexpress/{appId}/accounts
• POST /wxmaexpress/{appId}/accounts/bind|unbind|quota
• GET /wxmaexpress/{appId}/printers
• POST /wxmaexpress/{appId}/printers/bind|unbind
• POST /wxmaexpress/{appId}/orders
• POST /wxmaexpress/{appId}/orders/query|batch-query|cancel
• POST /wxmaexpress/{appId}/paths/query

直播成员

• GET /wxapp/list?appType=1
• GET /wxmalivemember/page
• POST /wxmalivemember/roles
• DELETE /wxmalivemember/roles

接口联调建议

1. 先调用账号列表，使用接口返回的 AppID。
2. 再调用只读查询确认租户和账号能力。
3. 写接口使用最小测试数据。
4. 同时查看 API 日志和微信错误码。
5. 写成功后再次调用查询接口确认微信最终状态。