Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fastwego/wxwork
[企业微信] A fast wxwork development sdk written in Golang
https://github.com/fastwego/wxwork
fastwego wechat wechat4work weixin
Last synced: 5 days ago
JSON representation
[企业微信] A fast wxwork development sdk written in Golang
- Host: GitHub
- URL: https://github.com/fastwego/wxwork
- Owner: fastwego
- License: other
- Created: 2020-08-06T12:33:02.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-01-11T06:34:45.000Z (almost 4 years ago)
- Last Synced: 2024-08-02T18:36:49.748Z (3 months ago)
- Topics: fastwego, wechat, wechat4work, weixin
- Language: Go
- Homepage: https://fastwego.dev
- Size: 596 KB
- Stars: 117
- Watchers: 7
- Forks: 31
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-starts - fastwego/wxwork - [企业微信] A fast wxwork development sdk written in Golang (Go)
README
# fastwego/wxwork
A fast [wxwork](https://work.weixin.qq.com/api/doc) development sdk written in Golang
[](https://pkg.go.dev/github.com/fastwego/wxwork?tab=doc)
[](https://goreportcard.com/report/github.com/fastwego/wxwork)
## 快速开始 & demo
```shell script
go get github.com/fastwego/wxwork
```
```go
// 创建企业实例
Corp = corporation.New(corporation.Config{Corpid: "CROPID"})
//创建通讯录 App
ContactApp = Corp.NewApp(corporation.AppConfig{
AgentId: "AGENTID",
Secret: "SECRET",
Token: "TOKEN",
EncodingAESKey: "EncodingAESKey",
})
// 通讯录管理 -> 获取部门成员详情
params := url.Values{}
params.Add("department_id", "10086")
resp, err := user.SimpleList(ContactApp, params)
```
完整演示项目：
[https://github.com/fastwego/wxwork-demo](https://github.com/fastwego/wxwork-demo)
接口列表：
[corporation/doc/apilist.md](corporation/doc/apilist.md)
## 架构设计
## 框架特点
### 快速
「快」作为框架设计的核心理念，体现在方方面面：
- 使用 Go 语言，开发快、编译快、部署快、运行快，轻松服务海量用户
- 丰富的[文档](https://pkg.go.dev/github.com/fastwego/wxwork) / [教程](corporation/doc/SUMMARY.md) 和 [演示代码](https://github.com/fastwego/wxwork-demo) ，快速上手，5 分钟即可搭建一套完整的微信服务
- 独立清晰的模块划分，快速熟悉整个框架，没有意外，一切都是你期望的样子
- 甚至连框架自身的大部分代码也是自动生成的，维护更新快到超乎想象
### 符合直觉
作为第三方开发框架，尽可能贴合官方文档和设计，不引入新的概念，不给开发者添加学习负担
### 简洁而不过度封装
作为具体业务和企业微信之间的中间层，专注于通道的角色：帮业务把配置/材料投递到企业微信，将企业微信响应/推送透传回业务
至于 [AccessToken 管理](corporation/doc/access_token.md) 和 [消息加解密处理](corporation/doc/message.md)，框架内部完成得干净利落，开发者甚至觉察不到存在
### 官方文档就是最好的文档
每个接口的注释都附带官方文档的链接，让你随时翻阅，省时省心
### 完备的单元测试
100% 覆盖每一个接口，让你每一次调用都信心满满
### 详细的日志
每个关键环节都为你完整记录，Debug 倍轻松，你可以自由定义日志输出，甚至可以关闭日志
### 多账号支持
一套服务支持多个企业微信账号，轻松成为第三方开发服务平台，业务节节高
### 支持服务集群
单台服务器支撑不住访问流量/想提高服务可用性？
只需 [设置 GetAccessTokenFunc 方法](https://pkg.go.dev/github.com/fastwego/wxwork/corporation?tab=doc#App.SetGetAccessTokenHandler) ，从中控服务获取 AccessToken，即可解决多实例刷新冲突/覆盖的问题
### 活跃的开发者社区
FastWeGo 是一套完整的微信开发框架，包括公众号、开放平台、微信支付、企业微信、小程序、小游戏等微信服务，拥有庞大的开发者用户群体
你遇到的所有问题几乎都可以在社区找到解决方案
## 参与贡献
欢迎提交 pull request / issue / 文档，一起让微信开发更快更好！
Faster we go together!
[加入开发者交流群](https://github.com/fastwego/fastwego.dev#%E5%BC%80%E5%8F%91%E8%80%85%E4%BA%A4%E6%B5%81%E7%BE%A4)