开发应用的一般步骤

• 1 . 打开明道开放平台网站http://open.mingdao.com,并使用明道账号登录

• 

• 2. 填写应用的相关信息

  

• 3. 在应用详情页,获取API令牌

  

• 4. 拼接Oauth2用户认证的URL,获取请求验证码code

  • Oauth2用户认证接口:http://open.mingdao.com/api/oauth2/authorize
  • https://api.mingdao.com/oauth2/authorize?app_key=[APP_Key]&redirect_uri=[Redirect_URI]
  • App_Key：之前获取的App_Key
  • Redirect_URL:在创建应用时填写的回调地址(这里我们以百度为例)
  • 在浏览器的地址栏中输入：
    https://api.mingdao.com/oauth2/authorize?app_key=C7276DB7C44D&redirect_uri=http://www.baidu.com
  • 

• 5. 用户授权后会将code参数反传给应用的回调地址

  
  注意：每当我们向浏览器提交请求获取code时，都会产生一个新的code，原先的code会失效

• 6. 通过Oauth2服务获取用户访问令牌

  • Oauth2获取授权过的令牌接口:http://open.mingdao.com/api/oauth2/access_token
  • https://api.mingdao.com/oauth2/access_token?app_key=[APP_Key]&app_secret=[APP_secret]&grant_type=authorization_code&code=[Code]&redirect_uri=[Redirect_URI]
  • App_Key：为第4步获取的应用的App_Key
  • APP_Secret,Redirect_URI这里不再解释。
  • Code为第六步获取的用户请求验证码
  • 在浏览器的地址栏中输入：
    https://api.mingdao.com/oauth2/access_token?app_key=C7276DB7C44D&app_secret=6188275EF965388891B3618BD9398A
    &grant_type=authorization_code&code=73e03d33ab294bd7b82fd1eb30dd16be&redirect_uri=http://www.baidu.com

• 7. 获取用户访问令牌

  

• 8. 尝试获取当前账户信息

  获取当前登录用户的基本信息API:https://api.mingdao.com/passport/detail

• 9. 如何与应用自身的用户系统绑定；多用户的企业应用如何建立企业账号和明道网络的关联？

  • 明道的应用分两种安装模式：
  • （1）企业安装：适用于有多用户特征或协同特性的系统，此类系统一般都有子账号或者企业账号（公司ID）的概念
  • 注：明道接口中的ProjectID就是客户公司在明道中的公司ID。http://open.mingdao.com/api/passport/detail
  • 对于“企业安装”模式的应用，当一个用户使用明道账号登录后，首先应当根据该用户所在公司是否已经存在于应用系统中，来判断这是一个新客户公司的首个用户，还是一个现有客户公司的后续用户。见下图
  • 
  • （2）个人安装：适用于 每个账号在系统内都是独立存在的，两个账号之间不共享数据，没有协同特性的系统 对于“个人安装”模式的应用，每一个明道用户，对应第三方应用系统内的一个独立用户，见下图
  • 

• 10. 多用户的企业应用如何通过明道通讯录接口邀请同事加入，然后通过自有的角色管理来分别赋权？

  • （1）使用明道通讯录接口，邀请同事加入第三方应用一起协作。
  • 通讯录接口http://open.mingdao.com/api/user/all
  • 
  • （2）第三方系统有自己独立的权限体系，系统的初始管理员可以设定为第一个使用明道账号登录的“明道应用管理员”，之后，所有后续进入第三方系统的用户，由该初始管理员再行分配权限。
  • 应用管理员接口http://open.mingdao.com/api/app/get_admin
  • 

• 11. 实现“用明道账号登录”的功能后,在应用详情页,点击“提交发布”来向明道申请在应用市场发布您的应用

  

• 12. 明道会在1-3个工作日处理您的申请,请及时关注待审应用的状态和审核结果的通知邮件.
  如果审核通过,您的“应用接入”类型的应用将在明道应用市场上线

  至此，网站或应用在明道应用市场发布上线的操作步骤已全部完成，以下为进阶内容，开发者可以根据实际情况选择性调用：

  进阶1:业务数据交换带来的价值，更多业务数据整合案例
  在明道，除了最常用的动态更新接口之外，您完全可以通过API 来实现明道Web端的所有基础应用的功能。 如果您的企业部署了明道，那么您完全可以将企业已有的IT系统与明道进行对接，实现账户对接，将必要的数据信息流转通过明道来实现，比方说任务分配、跟进等。 当然，也可以开发适合本企业的应用，围绕明道的基础框架来扩展明道。比方说，您可以将公司CRM销售系统产生的报表定期分享到明道不同的销售群组， 让相关销售人员主动得知销售数据，同时也提高CRM系统的使用率，使信息快速流转起来。
  
  进阶2:分享到明道
  分享到明道是一个独立的组件，通过规范的HTTP请求可以将外部系统的信息分享到明道，而不需要经过应用授权的过程， 具体可以参见http://open.mingdao.com/Document/share。

  如果您有任何疑问，可以写邮件到feedback@mingdao.com