接入成员资料页

如果你需要接入成员资料页，你可以依据本文档操作步骤进行接入。

前提条件

需要完成创建酷应用流程。

操作步骤

1. 选择扩展到成员资料页。

2. 在基础信息页面，配置成员资料页基础信息。

   配置项	必填	说明
   图标	是	酷应用图标，尺寸：240*240px，格式：PNG。默认使用主应用图标。
   名称	是	酷应用名称信息。
   描述	是	简要描述酷应用功能。

3. 单击功能设计，配置互动互动卡片模板,可以使用默认卡片模板快速体验。

   说明

   新建模板卡片模板参见更多信息创建通讯录卡片。

   

   配置项	说明
   卡片模板	填写说明：可以选择酷应用通讯录卡片示例。说明若选择新建模板卡片模板，请参考创建通讯录卡片。
   卡片数据回调服务	服务说明：卡片数据回调服务用于在成员资料页扩展时请求开发者获取到需卡片模板和卡片数据，获取到的数据将用于卡片的渲染。填写说明：请输入获取卡片数据的业务回调服务地址，用于获取卡片的数据。填写示例：https://dingtalk.com/profile/card/callback。

   确认配置无误后，单击右上角保存按钮。

4. 开发卡片数据回调，更多信息参考功能开发 > 获取脚手架与示例：

   1. 钉钉回调业务方数据结构（入参）：

{
    "content": "{\"dynamicDataSourceQueryRequests\":[{\"dynamicDataSourceId\":\"ds.profile\",\"dynamicParams\":{\"profile\":\"{\\\"corpId\\\":\\\"ding82cdb244a6246deca13*****1351\\\",\\\"userId\\\":\\\"015353405866731012128\\\"}\"}}]}",
    "corpId": "ding82cdb244a6246deca13*****1351",
    "outTrackId": "COOLAPP-10-101F10E26908213F1****.V47",
    "type": "dynamicDataCallback",
    "userId": "13330623764729"
}

名称	类型	是否必填	描述
userId	String	是	查看人在某企业下userId信息。
corpId	String	是	所属企业ID，从不同的入口进入成员资料页，企业ID不同。内部群&外部群查看成员资料页：返回该内部群&外部群所属的企业ID。单聊&普通群查看成员资料页：返回被查看人的主企业ID。说明个人主企业可以从何以下路径查看 移动端 > 左上角个人头像 > 点击个人头像 >企业/团队。
outTrackId	String	是	卡片实例唯一标识。
type	String	是	回调类型，目前是固定值dynamicDataCallback。
content	String	是	回调业务拓展信息。说明包含被查看人的企业ID和在企业I下的用户ID。

2. 业务方响应钉钉侧数据结构（出参）：

{
    "dataSourceQueryResponses": [
        {
            "data": "{\"profileUrl\":\"www.dingtalk.com\",\"profilePcUrl\":\"www.dingtalk.com\",\"isProfileOwner\":false,\"okrs\":[{\"name\":\"这是小钉新的目标，(进度会刷新)\",\"progress\":40}]}",
            "dynamicDataSourceId": "ds.profile",
            "dynamicDataValueType": "OBJECT"
        }
    ]
}

名称	类型	描述
data	Object	渲染卡片的私有数据对象，适合于设置每个人看到的不一样的卡片内容。
dynamicDataSourceId	String	数据源类型，目前钉钉平台要求必须返回固定值 ds.profile。
dynamicDataValueType	String	数据源data返回数据格式，目前钉钉平台要求必须返回固定值 OBJECT。

签名验证：

为了提升回调接口的安全性，从钉钉侧发起的HTTP回调请求，支持开发者进行来源校验。

如配置链接增强时提供了“卡片数据回调Secret”，则收到的HTTP请求Header中包含签名相关Header:

• x-ddpaas-signature-timestamp：签名时间戳

• x-ddpaas-signature：签名串

其中 <签名串> = calcSignature(apiSecret, <签名时间戳>)，apiSecret是配置时指定的“卡片数据回调Secret”

接口提供方应使用如下方法计算签名并验证签名串是否正确以防未授权的调用：

public static String calcSignature(String apiSecret, long ts) {
    try {
        Mac mac = Mac.getInstance("HmacSHA256");
        SecretKeySpec key = new SecretKeySpec(apiSecret.getBytes(), "HmacSHA256");
        mac.init(key);
        return Base64.getEncoder()
            .encodeToString(mac.doFinal(Long.toString(ts).getBytes()));
    } catch (NoSuchAlgorithmException | InvalidKeyException e) {
         throw new RuntimeException("sign api secret failed", e);
    }
}

说明

卡片数据响应，请参考成员资料页扩展互动卡片能力。

5. 单击预览发布 > **发布，**显示可见性设置。

6. 单击去设置，完成可见性设置。

   说明

   登录钉钉管理后台，需要企业子管理员权限。

   

   通讯录成员资料页可见性配置规则需要设置：展示范围和可见范围，支持按照部门、人、角色维度设置。

   

   说明

   自己看自己需要勾选 展示此信息的成员自己也可见

   

7. 扫码查看成员资料页扩展，使用移动端扫码快速体验。

   

   扫码预览，展示信息。

   

后续步骤

消息菜单酷应用完成发布后，需要完成主应用发布。