feat: 优化文档展示

This commit is contained in:
金喜@DingTalk 2024-01-16 14:37:59 +08:00 committed by GitHub
parent ffab4144be
commit cd76d89274
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 42 deletions

View File

@ -4,50 +4,17 @@ Go SDK for DingTalk Stream Mode API, Compared with the webhook mode, it is easie
钉钉支持 Stream 模式接入事件推送、机器人收消息以及卡片回调,该 SDK 实现了 Stream 模式。相比 Webhook 模式Stream 模式可以更简单的接入各类事件和回调。 钉钉支持 Stream 模式接入事件推送、机器人收消息以及卡片回调,该 SDK 实现了 Stream 模式。相比 Webhook 模式Stream 模式可以更简单的接入各类事件和回调。
## 快速开始 ## 开发教程
### 准备工作 在 [教程文档](https://opensource.dingtalk.com/developerpedia/docs/explore/tutorials/stream/overview) 中,你可以找到钉钉 Stream 模式的教程文档和示例代码。
* Go语言开发环境https://www.go.dev/ ## 特别说明
* 钉钉开发者账号,具备创建企业内部应用的权限,详见[成为钉钉开发者](https://open.dingtalk.com/document/orgapp/become-a-dingtalk-developer)
### 快速开始指南 因拼写错误,从旧版本升级到 v0.13.0 时候,需要将 register_callback_hanlder 修改为 register_callback_handler
1、创建企业内部应用 ### 参考资料
进入[钉钉开发者后台](https://open-dev.dingtalk.com/)创建企业内部应用获取ClientID即 AppKey和ClientSecret 即AppSecret * [Stream 模式说明](https://opensource.dingtalk.com/developerpedia/docs/learn/stream/overview)
* [教程文档](https://opensource.dingtalk.com/developerpedia/docs/explore/tutorials/stream/overview)
发布应用:在开发者后台左侧导航中,点击“版本管理与发布”,点击“确认发布”,并在接下来的可见范围设置中,选择“全部员工”,或者按需选择部分员工。 * [常见问题](https://opensource.dingtalk.com/developerpedia/docs/learn/stream/faq)
* [Stream 模式共创群](https://opensource.dingtalk.com/developerpedia/docs/explore/support/?via=moon-group)
2、Stream 模式的机器人(可选)
如果不需要使用机器人功能的话,可以不用创建。
在应用管理的左侧导航中,选择“消息推送”,打开机器人能力,设置机器人基本信息。
注意:消息接收模式中,选择 “Stream 模式”
![Stream 模式](https://img.alicdn.com/imgextra/i3/O1CN01XL4piO1lkYX2F6sW6_!!6000000004857-0-tps-896-522.jpg)
点击“点击调试”按钮,可以创建测试群进行测试。
3、启动应用
修改参数,启动应用
```Shell
go run example/*.go -client_id "your-client-id" -client_secret "your-client-secret"
```
测试效果:
![calcbot](https://img.alicdn.com/imgextra/i1/O1CN0124eJfc29J7aK1Jtzu_!!6000000008046-0-tps-1740-762.jpg)
### 事件订阅切换到 Stream 模式(可选)
进入钉钉开发者后台,选择企业内部应用,在应用管理的左侧导航中,选择“事件与回调”。
“订阅管理”中,“推送方式”选项中,选择 “Stream 模式”,并保存
### 技术支持
[点击链接加入Stream模式共创群交流](https://open-dingtalk.github.io/developerpedia/docs/explore/support/?via=moon-group)