# 介绍
争取 做最好用的 企业微信 SDK, 帮助开发者 以最方便 最省时间的方式接入企业微信。qiye-wechat-sdk 基于 Figen 封装, 覆盖 企业微信 所有API
## Quick Start
### Spring Boot 项目
Spring Boot 项目 使用步骤如下:
1. 引入maven依赖
```xml
<dependency>
<groupId>chat.qiye.wechat</groupId>
<artifactId>qiye-wechat-spring-boot-starter</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
```
2. 在 application.yaml 中加入 如下配置
```yaml
qiye:
wechat:
corp-id: ww5f09c98e13dfce02
apps:
- app-id: 1000015
agent-id: 1000015
app-type: app
secret: VYa3q7u-XkhQno-ROferY3mD16eFy_-h62pHJ0qM58I
- app-id: contact
agent-id: 88
app-type: contact
secret: okDLF2MXt3QRGfAQ2cENzNUxfLd3c-_vn60etURj0SY
```
3. 使用 相关 Api Bean
```java
@RestController
public class DeptController {
@Resource
ContactDeptApi contactDeptApi;
@GetMapping("/list")
public ContactDeptListResp list(@RequestParam(defaultValue = "0") Integer id) {
return contactDeptApi.list(id);
}
}
```
### 普通java项目 配置
普通 的Java 项目使用步骤如下:
1. 引入maven依赖
```xml
<dependency>
<groupId>chat.qiye.wechat</groupId>
<artifactId>qiye-wechat-sdk</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-1.2-api</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</dependency>
```
2. 在 resources 目录下 放一个 qiye-wechat.properties 配置文件
```properties
# 应用配置
qiye.wecaht.appId=1000015
qiye.wecaht.agentId=1000015
qiye.wecaht.secret=VYa3q7u-XkhQno-ROferY3mD16eFy_-h62pHJ0qM58I
qiye.wecaht.corpId=ww5f09c98e13dfce02
qiye.wecaht.homeUrl=http://baidu.com
qiye.wecaht.eventToken=ss
qiye.wecaht.eventEncodingAesKey=sddd
# 系统 应用配置格式, 系统应用ID参考 chat.qiye.wechat.sdk.constant.AppTypeEnum
# qiye.wecaht.系统应用ID.appId=contact
# qiye.wecaht.系统应用ID.agentId=88
# qiye.wecaht.系统应用ID.secret=okDLF2M1tkQRGfAQ2cENzNUxfLd3c-_vn60etURj0SY
# qiye.wecaht.系统应用ID.corpId=ww5f09c98e13dfce02 # 可选,未配置使用 qiye.wecaht.corpId
# qiye.wecaht.系统应用ID.homeUrl=http://baidu.com
# qiye.wecaht.系统应用ID.eventToken=ss
# qiye.wecaht.系统应用ID.eventEncodingAesKey=sddd
# 系统-通讯录应用
qiye.wecaht.contact.appId=contact
qiye.wecaht.contact.agentId=88
qiye.wecaht.contact.secret=okDLF2MXt3QRGfAQ2cENzNUxfLd3c-_vn60etURj0SY
qiye.wecaht.contact.corpId=ww5f09c98e13dfce02
qiye.wecaht.contact.homeUrl=http://baidu.com
qiye.wecaht.contact.eventToken=ss
qiye.wecaht.contact.eventEncodingAesKey=sddd
```
3. API调用
```java
public class MainClass {
public static void main(String[] args) {
// 获取Api实例, 所有封装的Api 都在 chat.qiye.wechat.sdk.api 包下,并以Api结尾
ContactDeptApi contactDeptApi = ApiFactory.getApiBean(ContactDeptApi.class, new ApiConfigurationDefaultProvider());
// 查询 通讯录 部门列表
List<ContactDeptVo> deptVoList = contactDeptApi.list(0).getDepartment();
System.out.println("DeptList:" + deptVoList);
// 创建部门
ContactDeptVo contactDeptVo = new ContactDeptVo();
contactDeptVo.setId(2);
contactDeptVo.setName("测试部");
contactDeptVo.setNameEn("test");
contactDeptVo.setParentid(1);
ContactDeptCreateResp resp = contactDeptApi.create(contactDeptVo);
if (resp.success()) {
RespStatus ret = contactDeptApi.delete(resp.getId());
System.out.println("delete result:" + ret);
}
}
}
```
## 进阶配置
## 多个企业微信内部应用
## 多个企业微信服务商应用
## 系统应用ID
系统应用 默认是 没有应用ID 但是 系统应用有单独的 secret,为了能够识别 系统应用的 secret 特此 对系统应用的id 进行统一定义,在配置文件中 配置时,需遵守如下名称
```java
DEFAULT("app", "自建应用"),
APP_CONTACT("contact", "通讯录"),
APP_CUSTOMER("customer", "客户关系"),
APP_CUSTOMER_SERVICE("customer_service", "微信客服"),
APP_MEETING("meeting", "会议"),
APP_SCHEDULE("schedule", "日程"),
APP_PUBLIC_PHONE("public_phone", "公费电话"),
APP_WX_DRIVE("wx_drive", "微盘"),
APP_LIVING("living", "直播"),
APP_CHECK_IN("check_in", "打卡"),
APP_APPROVAL("approval", "审批"),
APP_REPORT("report", "汇报"),
APP_MEETING_ROOM("meeting_room", "会议室"),
APP_PSTNCC("pstncc", "紧急通知"),
APP_SCHOOL_CONTACT("school_contact", "家校通讯录");
```
没有合适的资源?快使用搜索试试~ 我知道了~
基于 Feign 实现的企业微信 JAVA SDK, 覆盖 企业微信 所有API,spring-boot-start.zip
共583个文件
java:560个
xml:8个
gitkeep:7个
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 78 浏览量
2024-03-23
23:29:31
上传
评论
收藏 379KB ZIP 举报
温馨提示
基于 Feign 实现的企业微信 JAVA SDK, 覆盖 企业微信 所有API,spring-boot-start
资源推荐
资源详情
资源评论
收起资源包目录
基于 Feign 实现的企业微信 JAVA SDK, 覆盖 企业微信 所有API,spring-boot-start.zip (583个子文件)
spring.factories 118B
.gitignore 3KB
.gitkeep 0B
.gitkeep 0B
.gitkeep 0B
.gitkeep 0B
.gitkeep 0B
.gitkeep 0B
.gitkeep 0B
SchoolUserApi.java 12KB
OaCheckInApi.java 11KB
QiYeWeChatApiFactoryBean.java 9KB
CustomerMessageApi.java 7KB
ContactUserApi.java 6KB
QiYeWeChatApiRegistrar.java 6KB
QiyeWechatConfig.java 6KB
ApiDynamicTokenTarget.java 6KB
ConfigUtil.java 5KB
AppMessageApi.java 5KB
ContactSyncBatchApi.java 5KB
BaseApiUris.java 5KB
LinkedcorpApi.java 5KB
SchoolDeptApi.java 5KB
CustomerContactMeApi.java 5KB
ApiConfigurationDefaultProvider.java 5KB
QiYeWeChatAutoConfiguration.java 4KB
CustomerApi.java 4KB
CustomerTransferApi.java 4KB
OaApiUris.java 4KB
LivingApi.java 4KB
CustomerApiUris.java 4KB
CorpGroupApi.java 4KB
StringUtil.java 4KB
OaApprovalApi.java 4KB
SchoolApi.java 4KB
CorpApprovalDataQueryResp.java 3KB
CustomerMomentApi.java 3KB
CustomerTagApi.java 3KB
ApiConfigurationProvider.java 3KB
QiYeWeChatConfigProperties.java 3KB
AppManageApi.java 3KB
ContactSyncExportApi.java 3KB
ContactUserGetResp.java 3KB
ApiFactory.java 3KB
ApprovalDetailResp.java 3KB
GetJournalStatListResp.java 3KB
ContactUserParam.java 3KB
ContactTagApi.java 3KB
GetJournalDetailResp.java 3KB
WeDriveFileApi.java 3KB
SchoolApiUris.java 2KB
SpringBootConfigurationProvider.java 2KB
CustomerBatchResp.java 2KB
SchoolMessageApi.java 2KB
QiyeWechatConfigLoader.java 2KB
WeDriveApi.java 2KB
OaMeetingRoomApi.java 2KB
ScheduleGetListResp.java 2KB
CustomerGetResp.java 2KB
CorpPermanentCodeResp.java 2KB
AppChatMessageApi.java 2KB
CheckInRuleGroupItem.java 2KB
ScheduleVo.java 2KB
MeetingDetailResp.java 2KB
AppAuthApi.java 2KB
QiYeWeChatApi.java 2KB
LinkedCorpMessageDto.java 2KB
CustomerStatApi.java 2KB
CheckInDayDataItemVo.java 2KB
KfAccountApi.java 2KB
LivingDetailResp.java 2KB
OaScheduleApi.java 2KB
ThirdAccessTokenApi.java 2KB
CheckInDataResp.java 2KB
SchoolMessageDto.java 2KB
AgentInfoVo.java 2KB
AuthCorpInfoVo.java 2KB
CustomerGroupResp.java 2KB
AppInfoResp.java 2KB
MainClass2.java 2KB
ContactWayDto.java 1KB
ContactDeptApi.java 1KB
ApprovalApplyEventParam.java 1KB
Oauth2Api.java 1KB
AppMessageDto.java 1KB
OaMeetingApi.java 1KB
ContactService.java 1KB
MomentListDto.java 1KB
ExternalContactDto.java 1KB
Oauth2UserInfoResp.java 1KB
GetLivingWatchStatResp.java 1KB
AppTypeEnum.java 1KB
AssertUtil.java 1KB
PublicTelPhoneGetDialRecordResp.java 1KB
GroupWelcomeTemplateParam.java 1KB
OaReportApi.java 1KB
OaCalendarApi.java 1KB
CustomerUnassignedListResp.java 1KB
AuthMemberListResp.java 1KB
CustomerGroupApi.java 1KB
共 583 条
- 1
- 2
- 3
- 4
- 5
- 6
资源评论
Kwan的解忧杂货铺
- 粉丝: 2w+
- 资源: 3699
下载权益
C知道特权
VIP文章
课程特权
开通VIP
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功