1. 开始开发

获取CorpID和AppSecret

获取AgentID

获取code

1.1. 获取AgentID和AppSecret

应用注册完成后，可以查看应用的相关信息，如下图,参考这里

1.2. 获取corpid和code

1、由云助手跳转到第三方应用的时候在header头中包含了corpid和code信息，第三方应用可以从header中获取到这两个参数。见下图

注：code有效期为1分钟

获取header信息(PHP参考代码)：

$code = isset(\Yii::$app->request->headers["code"]) ? 
    \Yii::$app->request->headers["code"] : \Yii::$app->request->get('__sso_code');

$corpid = isset(\Yii::$app->request->headers["corpid"]) ? 
    \Yii::$app->request->headers["corpid"] : \Yii::$app->request->get('tenant_id');

部分手机可能会存在无法解析header头信息的问题，接入方可以做下兼容处理，云助手APP在打开应用时，同时会在 url中追加参数"__sso_code","tenant_id"，此参数的值与header中"code","corpid"的值等价

例子：通过云助手APP扫码下方二维码，打开的页面中会动态显示header信息

1.3. 获取租户自建应用的access_token

根据corpid和corpsecret获取获取access_token

接口地址：

https://www.fdccloud.com/api/third-app-open/get-access-token

传参方式 :

POST

参数：

{
  "corpid": "获取到的 CorpID",
  "corpsecret": "获取到的AppSecret"
}

返回结果

成功返回

{
  "errcode": 0,
  "errmsg": "ok",
  "data": {
    "access_token": "",
    "expires_in": 7200
  }
}

失败返回

{
  "errcode": "错误code",
  "errmsg": "错误信息",
  "data": ""
}

注意:

access_token有效期为7200秒

1.4. 开发应用逻辑

开发并完善你的应用逻辑和功能，如果你的应用需要使用云助手提供的开放能力，可以继续往下阅读

2. 调用对接接口

2.1. 免登接口

接口地址：

https://www.fdccloud.com/api/tenant-open/get-wzs-user-info?access_token=ACCESSTOKEN

传参方式：

POST

参数:

{
  "code": "用户code"
}

code有效期为1分钟，获取方式参考这里

返回结果

成功返回

{
  "errcode": 0,
  "errmsg": "ok",
  "data": {
    "openid": "云助手用户的openid",
    "user_name": "用户名称",
    "company": "所属公司名称",
    "tenant_code": "企业代码",
    "station": "所属岗位，多个用逗号分隔",
    "dept": "所属部门，多个用逗号分隔",
    "tel": "手机号",
    "wzs_user_id": "云助手用户的wzs_user_id",
    "user_code": "云助手用户的user_code",
    "erp_user_code": "绑定的erp中的user_code"
  }
}

失败返回

{
  "errcode": "错误代码",
  "errmsg": "错误信息",
  "data": ""
}

2.2. 消息推送接口

消息推送接口文档，戳这里

2.3. 通讯录接口

通讯录接口文档，戳这里

2.4. 功能模块注册

功能模块注册文档，戳这里

2.5. 应用角色注册

应用角色注册文档，戳这里

3. 网页开发SDK

网页开发部分的文档指引,戳这里

开发H5应用