Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

上下游应用改造文档完善 #19

Merged
merged 32 commits into from
Dec 20, 2023
Merged
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
e482f1a
添加权限中心文档架构
Sep 26, 2023
cd11d49
feat:添加描述
Sep 26, 2023
bffca3e
feat: 添加权限概述overview.md的文字部分,
Sep 26, 2023
56b7301
feat: 添加权限概述overview.md的文字部分
Sep 26, 2023
97259cb
feat: 委托访问和应用访问介绍完成
Oct 7, 2023
715336d
Merge branch 'main' into main
nn75 Oct 7, 2023
071d854
feat: 添加权限文档框架
Oct 7, 2023
ef6c48d
feat: 添加敏感权限开发文档
Oct 7, 2023
c06c411
Merge branch 'main' of github.com:nn75/developerpedia into main
Oct 7, 2023
35d2ad4
bugfix:修复链接问题
Oct 7, 2023
79680e0
refact: 调整术语规范
Oct 7, 2023
e2657c5
bugfix:修复链接问题
Oct 7, 2023
2c16470
Merge branch 'main' of github.com:nn75/developerpedia into main
Oct 8, 2023
e1f4e7f
feat: 添加用授权组件获取委托和应用access token的文档
Oct 8, 2023
d84ed6b
Merge branch 'main' of github.com:nn75/developerpedia into main
Oct 8, 2023
bb7396e
feat: 浏览器和jsapi获取access token的文档齐全
Oct 8, 2023
38bd94a
Merge branch 'main' of github.com:nn75/developerpedia into main
Oct 9, 2023
210af87
feat: 添加权限术语permission-glossary
Oct 9, 2023
e9987f0
feat: 添加“用户撤回权限”文档
Oct 10, 2023
4cd9b71
Merge branch 'open-dingtalk:main' into main
nn75 Oct 10, 2023
3b2bb14
feat: 添加授权管理相关文档
Oct 10, 2023
82dc6dd
Merge branch 'open-dingtalk:main' into main
nn75 Oct 10, 2023
f641f4d
test: 添加warning
Oct 12, 2023
2f145bb
feat: 缩小图片
Oct 12, 2023
f1500e7
Merge branch 'main' of github.com:nn75/developerpedia into main
Oct 12, 2023
6cfa5e0
Merge branch 'open-dingtalk:main' into main
nn75 Oct 12, 2023
cd53c4b
Merge branch 'open-dingtalk:main' into main
nn75 Oct 13, 2023
ed848c9
Merge branch 'open-dingtalk:main' into main
nn75 Oct 19, 2023
0490ee9
Merge branch 'main' of github.com:nn75/developerpedia into main
Dec 19, 2023
4845a25
feat:企业内部改造成上下游应用指导文献
Dec 19, 2023
bfde99e
Merge branch 'open-dingtalk:main' into main
nn75 Dec 20, 2023
03cf82e
上下游应用文档完善
Dec 20, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 15 additions & 18 deletions docs/develop/permission/single_to_multi/self_to_upstream.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,43 +16,40 @@ sidebar_position: 2
* 其次,开放平台的权限点分为两类:委托权限点和应用权限点。

:::info 开发者Tip
权限点类型在开发者后台的透出正在开发中,现在如果你想知道某个权限点属于委托还是应用,请咨询开放平台同学 **@泽少**
权限点类型在开发者后台的透出正在开发中,现在如果你想知道某个权限点属于委托还是应用,欢迎进群咨询:“钉钉权限系统交流群”,群号: 27520024199
:::

* 最终,你可以整理出类似下方表格:

| | 权限点code | 权限信息 | 权限点类型 |
|:----|:----------------------------|:---------------|:------|
| 1 | Contact.User.Read | 通讯录个人信息读权限 | 委托权限点 |
| 2 | Calendar.EventSchedule.Read | 日历应用中日程闲忙状态读权限 | 委托权限点 |
| 3 | qyapi_chat_manage | 钉钉群消息管理权限 | 应用权限点 |
| 4 | qyapi_chat_read | 钉钉群消息读权限 | 应用权限点 |
| 1 | Contact.User.Read | 通讯录个人信息读权限 | 委托类型 |
| 2 | Calendar.EventSchedule.Read | 日历应用中日程闲忙状态读权限 | 委托类型 |
| 3 | qyapi_chat_manage | 钉钉群消息管理权限 | 应用类型 |
| 4 | qyapi_chat_read | 钉钉群消息读权限 | 应用类型 |
| 5 | ... | ... | ... |


## 二、调用OpenAPI

### 2-1 获取访问凭证
* 如果你想调用委托权限点对应的OpenAPI,参考文档[浏览器内获取用户委托的访问凭证](/docs/develop/permission/token/browser/get_user_app_token_browser)
或[钉钉端内获取用户委托的访问凭证](/docs/develop/permission/token/jsapi/get_user_app_token_jsapi),获取用户委托的Access Token。
* 用户委托的Access Token中有用户授权的所有委托权限点,可以用于调用委托权限点对应的OpenAPI。


* 如果你想调用应用权限点对应的OpenAPI。参考文档[浏览器内获取应用的访问凭证](/docs/develop/permission/token/browser/get_app_only_token_browser)
或[钉钉端内获取应用的访问凭证](/docs/develop/permission/token/jsapi/get_app_only_token_jsapi),获取应用的Access Token。
* 应用的Access Token中有组织管理员授权的所有应用权限点,可用于调用应用权限点对应的OpenAPI。
* 如果你参考[浏览器内获取应用的访问凭证](/docs/develop/permission/token/browser/get_app_only_token_browser),请按照流程开发,除了在**步骤 2-2:用 ClientId 和 ClientSecret 获取 Access Token**,使用新的获取Access Token接口:[获取应用的Access Token[新🔥] ](/docs/develop/permission/single_to_multi/new_get_app_token)。
* 如果你参考[钉钉端内获取应用的访问凭证](/docs/develop/permission/token/jsapi/get_app_only_token_jsapi),请按照流程开发,除了在**步骤三:获取应用的访问凭证**,使用新的获取Access Token接口:[获取应用的Access Token[新🔥] ](/docs/develop/permission/single_to_multi/new_get_app_token)。
* 如果你的应用需要调用 **委托类型权限点** 对应的 OpenAPI,请参考文档 [浏览器内获取用户委托的访问凭证](/docs/develop/permission/token/browser/get_user_app_token_browser)
或 [钉钉端内获取用户委托的访问凭证](/docs/develop/permission/token/jsapi/get_user_app_token_jsapi),获取用户委托的Access Token。
* 用户委托的Access Token中有用户授权的所有委托类型权限点,可以用于调用委托类型权限点对应的OpenAPI。

* 如果你的应用需要调用 **应用类型权限点** 对应的 OpenAPI。请参考文档 [获取应用的Access Token[新🔥] ](/docs/develop/permission/single_to_multi/new_get_app_token),获取应用的Access Token。
* 应用的Access Token中有所有应用类型权限点,可用于调用应用类型权限点对应的OpenAPI。

### 2-2 调用OpenAPI
* 用用户委托的Access Token,调用委托权限点对应的OpenAPI
* 用应用的Access Token,调用应用权限点对应的OpenAPI
* 用用户委托的Access Token,调用委托类型权限点对应的OpenAPI
* 用应用的Access Token,调用应用类型权限点对应的OpenAPI


## 三、上下游分发
在完成上方的代码改造后,你可以把应用通过开发者后台的上下游分发渠道,分发给下游组织使用。

## 四、其他
* 如果你想了解更多关于委托权限和应用权限的知识,可以移步[委托访问](/docs/learn/permission/intro/delegated_permission)和[应用访问](/docs/learn/permission/intro/application_permission)。
* 如果你在改造过程中有任何问题,请联系开放平台同学 **@泽少** 或 **@司沐** 。
* 如果以上方式无法解决你的问题,欢迎通过[技术支持](/docs/explore/support)提交你的反馈 。
* 如果你在改造过程中有任何问题,欢迎进群咨询:“钉钉权限系统交流群”,群号: 27520024199。
* 如果该问题还有其他的因素需要考虑,也欢迎你[参与贡献](/docs/contrib/overview)完善该文档,帮助更多人解决上下游应用问题。
Loading