我开始使用Teambition 行业解决方案 让团队协作飞起来

如何自建应用

一、快速开始

你可以通过简单的方式创建一个应用通过 首页管理后台 --> 应用管理 --> 新建应用 填写应用名称以及所属企业。

开发者中心首页

image.png

二、新建应用

image.png

确认填写完毕上述信息后你可以继续为应用补充 应用图标 描述 以及 帮助和反馈的网址, 获取应用的 Client IDClient Secret

center.png

三、接入指南

接入第一个应用,需要按照如下步骤完成:

1. 配置 OAuth2, 填写回调地址

2. 验证配置的有效性, 换取 access_token

3. 验证 access_token 是否合法(可选)

4. 实现业务逻辑

第一步、配置 OAuth 2

登录 Teambition 开发者中心后,进入应用管理界面,选择 OAuth2 配置,填写回调地址(Teambition 将通过填写的回调地址返回一次性授权码),配置的信息将会立刻生效,请谨慎填写

示例:配置 https://www.teambition.com 为回调地址

oauth2.png

获取一次性授权码(code)

1. 访问授权地址, 浏览器访问 https://account.teambition.com/oauth2/authorize?client_id=client_id&redirect_uri=回调地址 若成功访问则会弹出如下授权信息,若已授权则会跳过此步

示例  
client_id: f01213e0-6056-11e7-aa6d-d1662b15a448  
授权回调地址: https://www.teambition.com

请求URL: https://account.teambition.com/oauth2/authorize?client_id=f01213e0-6056-11e7-aa6d-d1662b15a448&redirect_uri=https%3A%2F%2Fwww.teambition.com


下左图为已登录的情况,右图为
未登录的情况:

image.png

2. 点击登录并授权,成功后会重定向到你所填写的回调地址,并在url中携带授权码(code)

 示例: https://www.teambition.com/?code=swdMY_N8p5jFCbg8ZWbDLkbP


3. 根据回调地址上携带的一次性授权码(code), 根据接口获取授权token(access_token), 了解更多 关于OAuth 2机制

第二步, 换取 access_token

access_token 是调用接口的凭据,各接口调用时都需携带access_token。你需要进行妥善保存。

你可以通过应用中心提供的 Client IDClient Secret 来换取 access_token

接口调用流程:

https请求方式:POST
URL: https://account.teambition.com/oauth2/access_token

参数列表

image.png返回说明

正常情况下,teambition会返回下述JSON数据:


{
  "access_token": "ACCESS_TOKEN", // 获取到的凭证,用于调用接口
  "refresh_token":"REFRESH_TOKEN" // 兼容处理
}


第三步, 验证 access_token 是否合法

接口调用流程:

https请求方式:GET 
URL: https://api.teambition.com/api/applications/:client_id/tokens/check

参数列表

image.png示例

GET https://api.teambition.com/users/me
// header
Authorization: OAuth2 access_token

注 : OAuth2 与 access_token 间仅有一个空格

返回说明

合法则返回200, 否则返回404


第四步, 开发第一个应用

现在你已经成功的获得了调用teambition接口的凭证(access_token), 可以进入 API文档中心 选择你要使用的接口进行调用


第五步, 安装第一个应用

审核通过的应用如何安装应用到我的项目中

以 我的能力为例  

1.进入应用管理后台, 开启 我的能力, 并配置PC端的入口地址, 如下:

my.png

2.配置并保存完毕后, 点击 测试安装:

image.png

3.安装成功后, 进入企业 管理后台,查看自建应用确认应用安装:

image.png

4.进入项目,  点击我的查看,成功:

nengli.png

调用示例

以 postman 为工具, 获取我的信息

https请求方式: get

url: https://api.teambition.com/users/me 

me.png


更多支持方式

视频资源 功能文档 建议反馈