├── .gitignore
├── .vscode
└── launch.json
├── LICENSE
├── README.md
├── __test__
├── .dingtalkMain.go
├── GetCompanyDingTalkClient.go
├── getAuthScopes_test.go
├── getCompanyAccessToken_test.go
├── getCompanyTicket_test.go
├── index.html
├── mediaDownloadFile_test.go
├── mediaUpload_test.go
└── wow.jpg
├── dingtalk-tools.go
├── docs
├── .vuepress
│ └── config.js
├── README.md
├── guide
│ ├── README.md
│ ├── getting_started.md
│ ├── open_api_auth.md
│ ├── open_api_user.md
│ └── top_api.md
└── weixin.png
├── runner
└── runner.go
└── src
├── constants.go
├── crypto.go
├── dingtalk.go
├── open_api_auth.go
├── open_api_callback.go
├── open_api_chat.go
├── open_api_cspace.go
├── open_api_data.go
├── open_api_department.go
├── open_api_file.go
├── open_api_media.go
├── open_api_message.go
├── open_api_microapp.go
├── open_api_response.go
├── open_api_smartwork.go
├── open_api_sns.go
├── open_api_sso.go
├── open_api_user.go
├── request.go
├── top_api.go
├── top_api_response.go
└── util.go
/.gitignore:
--------------------------------------------------------------------------------
1 | # Binaries for programs and plugins
2 | *.exe
3 | *.dll
4 | *.so
5 | *.dylib
6 |
7 | # Test binary, build with `go test -c`
8 | *.test
9 |
10 | # Output of the go coverage tool, specifically when used with LiteIDE
11 | *.out
12 |
13 | # Project-local glide cache, RE: https://github.com/Masterminds/glide/issues/736
14 | .glide/
15 | .company_access_token_file
16 | .company_ticket_file
17 | debug
18 | debug.test
19 | .idea
--------------------------------------------------------------------------------
/.vscode/launch.json:
--------------------------------------------------------------------------------
1 | {
2 | // 使用 IntelliSense 了解相关属性。
3 | // 悬停以查看现有属性的描述。
4 | // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
5 | "version": "0.2.0",
6 | "configurations": [
7 | {
8 | "name": "Connect to server",
9 | "type": "go",
10 | "request": "launch",
11 | "mode": "remote",
12 | "remotePath": "${workspaceRoot}",
13 | "port": 2345,
14 | "host": "127.0.0.1",
15 | "program": "${workspaceRoot}",
16 | "env": {},
17 | "args": []
18 | },
19 | {
20 | "name": "Launch",
21 | "type": "go",
22 | "request": "launch",
23 | "mode": "debug",
24 | "remotePath": "",
25 | "port": 2345,
26 | "host": "127.0.0.1",
27 | "program": "${fileDirname}",
28 | "env": {},
29 | "args": [],
30 | "showLog": true
31 | }
32 | ]
33 | }
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2018
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # DingTalk Golang SDK
2 |
3 | DingTalk Golang SDK https://github.com/icepy
4 |
5 | # Feature Overview
6 |
7 | - 支持ISV，企业，SSO，SNS（H5 Web App）免登
8 | - 支持个人小程序免登
9 | - 支持对access_token自动续期过期管理（已使用独占锁，请勿再加锁）
10 | - 支持注册钉钉事件回调
11 | - 支持对钉钉事件回调消息签名的加解密
12 | - 支持全部 Open api
13 | - 支持全部 Top api，并且自动处理生成加密签名
14 |
15 | # Test
16 |
17 | - Test get auth scopes
18 | - Test get company acess_token
19 | - Test get company ticket
20 | - Test upload file
21 | - Test download file
22 |
23 | ```bash
24 | ~ ᐅ cd __test__
25 | ~ ᐅ go test
26 | ```
27 |
28 | # Install
29 |
30 | ```bash
31 | ~ ᐅ go get -u github.com/icepy/go-dingtalk
32 | ~ ᐅ go-dingtalk
33 | Current SDK VERSION=0.1
34 | Current SDK OAPIURL=https://oapi.dingtalk.com/
35 | Current SDK TOPAPIURL=https://eco.taobao.com/router/rest
36 | ~ ᐅ
37 | ```
38 |
39 | # Guide
40 |
41 | ```bash
42 | ~ ᐅ npm i -g vuepress
43 | ~ ᐅ cd docs
44 | ~ ᐅ vuepress dev
45 | ```
46 |
47 | # Help
48 |
49 | **Example**
50 |
51 | ```go
52 | package main
53 |
54 | import (
55 | "os"
56 | "github.com/icepy/go-dingtalk/src"
57 | )
58 |
59 | func main() {
60 | c := getCompanyDingTalkClient()
61 | c.RefreshCompanyAccessToken()
62 | }
63 |
64 | func getCompanyDingTalkClient() *dingtalk.DingTalkClient {
65 | CorpID := os.Getenv("CorpId")
66 | CorpSecret := os.Getenv("CorpSecret")
67 | config := &dingtalk.DTConfig{
68 | CorpID: CorpID,
69 | CorpSecret: CorpSecret,
70 | }
71 | c := dingtalk.NewDingTalkCompanyClient(config)
72 | return c
73 | }
74 |
75 | ```
76 |
77 | **ISV免登讲解**
78 |
79 | - 首先调用RefreshSuiteAccessToken刷新suite_access_token
80 | - 等待钉钉推送临时Code给你
81 |
82 | ```go
83 | // 假设你在服务端部署了get_code服务
84 | package main
85 |
86 | import (
87 | "fmt"
88 | "log"
89 | "net/http"
90 | )
91 |
92 | func GetCode(w http.ResponseWriter, req *http.Request) {
93 | // 获取临时授权code
94 | // 并返回{success:true}
95 | }
96 |
97 | func main() {
98 | http.HandleFunc("/get_code", GetCode)
99 | err := http.ListenAndServe("localhost:8080", nil)
100 | if err != nil {
101 | log.Fatal("ListenAndServe: ", err.Error())
102 | }
103 | }
104 | ```
105 | - 调用IsvGetPermanentCode
106 | - 调用IsvActivateSuite给企业激活套件
107 | - 调用IsvGetCorpAccessToken获取企业的access_token
108 |
109 | ⚠️至此，你要注意
110 |
111 | - 只有isv的suite_access_token是单例
112 | - corp_access_token是不同的，企业a换取来的corp_access_token是1，企业b换取来的corp_access_token是2
113 | - 建议：**isv可以用Redis，总之是这种key-value的存储来维护corp_access_token，企业的永久授权码是不会变的。在没过期之前，根据永久授权码从map里拿corp_access_token，如果过期了，又走一次流程，换取新的永久授权码，继续存入map，更新key-value系统。**
114 |
115 | # Contribute
116 |
117 | - For a small change, just send a PR.
118 | - For bigger changes open an issue for discussion before sending a PR.
119 | - PR should have:
120 | - Test case
121 | - Documentation
122 | - Example (If it makes sense)
123 | - You can also contribute by:
124 | - Reporting issues
125 | - Suggesting new features or enhancements
126 | - Improve/fix documentation
127 |
128 | # 打赏
129 |
130 |
131 |
132 |