1. 获取corpid和code

由云助手跳转到第三方应用的时候在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"的值等价

2. 获取应用的access_token

根据corpid和corpsecret获取获取access_token

接口地址：

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

传参方式 :

POST

参数：

{
  "corpid": "从header中获取corpid,标识租户用的，也可以直接使用云助手的租户代码tenant_code",
  "corpsecret": "在注册应用时，由云助手团队分配"
}

返回结果

成功返回

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

失败返回

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

注意:

1. access_token有效期为7200秒

3. 免登接口

接口地址：

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": ""
}

4. 回填手机号接口

此接口目前只开放给地产智库，其他应用不要调用此接口

接口地址：

https://www.fdccloud.com/api/tenant-open/update-user-tel?access_token=ACCESSTOKEN

传参方式：

POST

参数:

{
  "openid": "从免登接口中获取",
  "user_tel": "从免登接口中获取"
}

corpid的获取，参考这里

返回结果

{
  "errcode": "错误代码",// 0:成功 其他:失败
  "errmsg": "错误信息",
  "data": ""
}

5. 消息推送接口

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

6. 通讯录接口

通讯录接口文档，戳这里

7. 功能模块注册

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

8. 应用角色注册

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

9. 应用付费功能模块

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