专区程序开发指引

阅读时间:

3

min

文章字数:

660

字

发布日期:

2025-06-26

最近更新:

2025-10-23

阅读量:

-

travel

本内容主要解决的问题是应用后台如何快速通过专区程序接入企业微信后台API

专区程序以java为主,我们将java版本的示例源码下载下来

注: 专区程序SDK只能在Linux上运行,暂不支持windows和macOS.并且主机必须能连通外网以及使用HTTPS协议

专区程序SDK和示例下载

专区程序本地调试

调试说明: https://developer.work.weixin.qq.com/document/path/100086

SpecDemo.java

注意demo中SpecDemo.java 启动类中的参数说明

    Options options = new Options();
    options.addOption("d", true, "debugToken 调试模式时必须传该参数");
    options.addOption("a", true, "accessToken 调试模式时必须传该参数");
    options.addOption("i", true, "io worker thread count NioEventLoop worker线程池大小，默认为256。若开启业务线程执行，io线程建议调小");
    options.addOption("b", true, "business worker thread count  自定义业务worker线程池大小，默认为256，仅当processInIoThread为1时生效");
    options.addOption("p", true, "processInIoThread 业务逻辑是否在io线程执行。1:使用io线程执行业务逻辑 0: 使用自定义业务线程执行业务逻辑，默认为1");
    options.addOption("m", true, "monitor interval 监控线程打日志时间间隔，默认为60s");

启动命令

在本地调试模式下,必须启用 -a 和 -d 参数,否则验签不会通过

专区程序启动默认端口是8080,在启动后需要为专区程序配置https协议和域名

java -Dfile.encoding=UTF-8   
-jar SpecDemo-1.0-SNAPSHOT-jar-with-dependencies.jar 
-a  accessToken
-d debugToken

企业微信后台如何调用本地部署的专区程序

在调试模式下,企业微信后台通过事件的形式推送到你的专区程序

开启专区程序的调试模式

在调试模式下调试专区程序,必须先调用此接口

接口文档: https://developer.work.weixin.qq.com/document/path/100087

请求方式: POST

接口地址: https://qyapi.weixin.qq.com/cgi-bin/chatdata/open_debug_mode?access_token=ACCESS_TOKEN

关闭专区调试模式

调试完成后，需要调用关闭专区调试模式接口关闭调试模式

接口文档: https://developer.work.weixin.qq.com/document/path/100088

请求方式: POST

接口地址: https://qyapi.weixin.qq.com/cgi-bin/chatdata/close_debug_mode?access_token=ACCESS_TOKEN

专区程序发布

发布流程:上传镜像文件 -> 创建能力 -> 提交审核 -> 启动

在本地调试模式验证通过后,我们直接可以下载官方的专区程序镜像文件进行部署