文档

版本变更日志参见 CHANGELOG.md

更多相关文章将会在公众号分享，欢迎关注！

文档

V2版本升级

http请求改用go-resty可方便指定重试、错误处理hooks(当前未处理)

使用

go get github.com/go-laoji/wecom-go-sdk/v2

增加SetProxy(proxyUrl string) 对绕过IP限制有用,可参考OpenResty(nginx)配置正向代理绕过企微自建IP限制

增加SetDebug(debug bool) 可以监控http请求,看如下的输出

GET  /cgi-bin/gettoken?corpid=wp0k1qEQAAiwQMWYzF8JOr99RJRX1_1A&corpsecret=Y2YbFpt95RcGTs9CvriQ2uj23Wl8B3IxtbRM9nKfjVU  HTTP/1.1
HOST   : qyapi.weixin.qq.com
HEADERS:
    Accept: application/json;charset=UTF-8
    Content-Type: application/json;charset=UTF-8
    User-Agent: wecom-go-sdk-v2
BODY   :
***** NO CONTENT *****
------------------------------------------------------------------------------
~~~ RESPONSE ~~~
STATUS       : 200 OK
PROTO        : HTTP/2.0
RECEIVED AT  : 2023-06-10T21:03:57.834584+08:00
TIME DURATION: 181.642531ms
HEADERS      :
    Content-Length: 176
    Content-Type: application/json; charset=UTF-8
    Date: Sat, 10 Jun 2023 13:03:58 GMT
    Error-Code: 40001
    Error-Msg: invalid credential, hint: [1686402237354962763423746], from ip: 123.116.182.237, more info at https://open.work.weixin.qq.com/devtool/query?e=40001
    Server: nginx
BODY         :
{
   "errcode": 40001,
   "errmsg": "invalid credential, hint: [1686402237354962763423746], from ip: 123.116.182.237, more info at https://open.work.weixin.qq.com/devtool/query?e=40001"
}
==============================================================================

配置文件格式

CorpId: wwxxx
ProviderSecret: xxxxxxx
SuiteId: xxxxx
SuiteSecret: xxxxx-Gl8VA
SuiteToken: xxxxx
SuiteEncodingAesKey: xxxx
Dsn: user:pass@tcp(127.0.0.1:3306)/suite?charset=utf8mb4&parseTime=True&loc=Local
Port: 8080

　目录结构

├── config  解析yaml配置文件
├── example　样例程序
├── internal　内部函数，包含error和http请求
└── pkg 附加包
    └── svr 服务端接口部分
        ├── callback　指令及数据回调
        ├── install 应用安装连接生成、应用安装后的跳转
        ├── logic　各事件通知处理逻辑
        ├── middleware　gin的中间件方便handler里引入sdk
        └── models  应用安装时常用到的表定义,基于gorm

第三方包

github.com/dgraph-io/badger/v3 v3.2103.5 一个KeyValue数据库,类redis
github.com/gin-gonic/gin v1.9.1 web框架
github.com/go-laoji/wxbizmsgcrypt v1.0.0 微信数据加解密
github.com/jinzhu/copier v0.3.5 jinzhu大神的数据拷贝库
go.uber.org/zap v1.24.0 日志库
gopkg.in/natefinch/lumberjack.v2 v2.2.1 日志切割
gopkg.in/yaml.v2 v2.4.0 yaml解析
gorm.io/driver/mysql v1.5.1 同属jinzhu大神的mysql驱动
gorm.io/gorm v1.25.1 同属jinzhu大神的orm库

Name		Name	Last commit message	Last commit date
Latest commit History 237 Commits
.github/workflows		.github/workflows
config		config
example		example
internal		internal
pkg		pkg
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
NOTICE.md		NOTICE.md
README.md		README.md
agent.go		agent.go
corp_tag.go		corp_tag.go
department.go		department.go
edu.go		edu.go
edu_department.go		edu_department.go
edu_living.go		edu_living.go
edu_parent.go		edu_parent.go
edu_payment.go		edu_payment.go
edu_student.go		edu_student.go
external_contact.go		external_contact.go
external_contact_statistics.go		external_contact_statistics.go
external_contact_way.go		external_contact_way.go
external_intercept_rule.go		external_intercept_rule.go
external_message.go		external_message.go
external_pay.go		external_pay.go
external_product_album.go		external_product_album.go
external_welcome.go		external_welcome.go
go.mod		go.mod
groupchat.go		groupchat.go
id_convert.go		id_convert.go
init.go		init.go
invoice.go		invoice.go
jsticket.go		jsticket.go
kf.go		kf.go
kf_knowledge.go		kf_knowledge.go
license.go		license.go
media.go		media.go
message.go		message.go
message_template_card.go		message_template_card.go
moment.go		moment.go
msg_audit.go		msg_audit.go
provider.go		provider.go
qrcode.png		qrcode.png
suite.go		suite.go
tag.go		tag.go
transfer_customer.go		transfer_customer.go
user.go		user.go
wework.go		wework.go

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Licenses found

Repository files navigation

文档

V2版本升级

使用

配置文件格式

目录结构

第三方包

API列表

About

Licenses found

Releases

Contributors 5

Languages

License

Licenses found

go-laoji/wecom-go-sdk

Folders and files

Latest commit

History

Repository files navigation

文档

V2版本升级

使用

配置文件格式

目录结构

第三方包

API列表

About

Topics

Resources

License

Licenses found

Stars

Watchers

Forks

Releases

Contributors 5

Languages

　目录结构