钉工牌实现用户访客码创建

本文档介绍了如何调用钉工牌接口实现用户访客码创建的相关流程。首先创建一个企业内部应用，再使用钉工牌提供的API，实现配置企业钉工牌、创建钉工牌电子码、更新钉工牌电子码流程。

预期效果

流程简介

步骤一：登录开发者后台，创建企业内部应用。

步骤二：获取AppKey和AppSecret。

步骤三：申请钉工牌接口权限。查找“钉工牌”，申请相应的权限。

步骤四：获取应用访问凭证获取企业内部应用的accessToken。

步骤五：调用服务端钉工牌相关API。

调用服务端API-配置企业钉工牌接口，为企业开通钉工牌电子码。

调用服务端API-创建钉工牌电子码接口，进行用户访客码的创建，获取用户码codeId。

根据用户码codeId，调用服务端API-更新钉工牌电子码接口，进行用户访客码的更新。

更多详情请参考能力融合方案

查看能力融合方案

步骤一：创建企业内部应用

开发者后台

，创建

企业内部应用

。

填写应用的基本信息，然后单击确定创建。

应用类型：选择H5微应用。

开发方式：选择企业自主开发。

步骤二：获取AppKey和AppSecret

获取AppKey和AppSecret。

步骤三：添加接口权限

申请钉工牌接口权限，查找“钉工牌”，申请相应权限。

步骤四：获取应用访问凭证accessToken

根据步骤二中的AppKey和AppSecret，获取应用访问凭证获取企业内部应用的accessToken

 public void getAccessToken() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkoauth2_1_0.Client client = new com.aliyun.dingtalkoauth2_1_0.Client(config);
        GetAccessTokenRequest accessTokenRequest = new GetAccessTokenRequest()
                .setAppKey("din*********hgn")
                .setAppSecret("9G_O************mBkhgGIO");
        GetAccessTokenResponse accessToken = client.getAccessToken(accessTokenRequest);
        System.out.println(JSON.toJSONString(accessToken.getBody()));
    }

步骤五：调用服务端钉工牌相关API

调用服务端API-

配置企业钉工牌

接口，为企业开通钉工牌访客码。

说明配置企业钉工牌中参数codeIdentity选择访客码标识DT_VISITOR。

public void badgeConfigure() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkbadge_1_0.Client client = new com.aliyun.dingtalkbadge_1_0.Client(config);
        SaveBadgeCodeCorpInstanceHeaders saveBadgeCodeCorpInstanceHeaders = new SaveBadgeCodeCorpInstanceHeaders();
        saveBadgeCodeCorpInstanceHeaders.xAcsDingtalkAccessToken = "accessToken";
        Map<String,String> map = new HashMap<>();
        map.put("supportRelateAlipay","true");
        SaveBadgeCodeCorpInstanceRequest saveBadgeCodeCorpInstanceRequest = new SaveBadgeCodeCorpInstanceRequest()
                .setCodeIdentity("DT_VISITOR")
                .setCorpId("ding16b241fd05c8******5d8e4f7c288")
                .setStatus("OPEN")
                .setExtInfo(map);
        try {
            SaveBadgeCodeCorpInstanceResponse saveBadgeCodeCorpInstanceResponse = client.saveBadgeCodeCorpInstanceWithOptions(saveBadgeCodeCorpInstanceRequest, saveBadgeCodeCorpInstanceHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(saveBadgeCodeCorpInstanceResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

调用服务端API-

创建钉工牌电子码

接口，进行用户访客码的创建，获取用户码codeId。

说明创建钉工牌电子码中参数codeIdentity选择访客码标识DT_VISITOR。

public void  createBadgeCode() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkbadge_1_0.Client client = new com.aliyun.dingtalkbadge_1_0.Client(config);
        CreateBadgeCodeUserInstanceHeaders createBadgeCodeUserInstanceHeaders = new CreateBadgeCodeUserInstanceHeaders();
        createBadgeCodeUserInstanceHeaders.xAcsDingtalkAccessToken = "accessToken";
        CreateBadgeCodeUserInstanceRequest.CreateBadgeCodeUserInstanceRequestAvailableTimes availableTimes0 = new CreateBadgeCodeUserInstanceRequest.CreateBadgeCodeUserInstanceRequestAvailableTimes()
                .setGmtStart("2022-11-23 00:00:00")
                .setGmtEnd("2022-11-24 00:00:00");

        Map<String,String> map = new HashMap<>();
        map.put("applicantName","小钉");
        map.put("applyTime","2022-11-23 00:00:00");
        map.put("visitorName","小七");
        map.put("visitorMobile","86-155****3240");
        CreateBadgeCodeUserInstanceRequest createBadgeCodeUserInstanceRequest = new CreateBadgeCodeUserInstanceRequest()
                .setRequestId("202211231001")
                .setCodeIdentity("DT_VISITOR")
                .setCodeValue("badgeCode_11231001")
                .setStatus("OPEN")
                .setCorpId("ding16b241fd05c8******5d8e4f7c288")
                .setUserCorpRelationType("INTERNAL_STAFF")
                .setUserIdentity("manager7675")
                .setGmtExpired("2022-11-24 00:00:00")
                .setExtInfo(map)
                .setAvailableTimes(java.util.Arrays.asList(
                        availableTimes0
                ));
        try {
            CreateBadgeCodeUserInstanceResponse badgeCodeUserInstanceWithOptions = client.createBadgeCodeUserInstanceWithOptions(createBadgeCodeUserInstanceRequest, createBadgeCodeUserInstanceHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(badgeCodeUserInstanceWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据用户码codeId，调用服务端API-

更新钉工牌电子码

接口，进行用户访客码的更新。

说明更新钉工牌电子码中参数codeIdentity选择访客码标识DT_VISITOR。

public void updateBadgeCode() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkbadge_1_0.Client client = new com.aliyun.dingtalkbadge_1_0.Client(config);
        com.aliyun.dingtalkbadge_1_0.models.UpdateBadgeCodeUserInstanceHeaders updateBadgeCodeUserInstanceHeaders = new com.aliyun.dingtalkbadge_1_0.models.UpdateBadgeCodeUserInstanceHeaders();
        updateBadgeCodeUserInstanceHeaders.xAcsDingtalkAccessToken = "accessToken";
        com.aliyun.dingtalkbadge_1_0.models.UpdateBadgeCodeUserInstanceRequest.UpdateBadgeCodeUserInstanceRequestAvailableTimes availableTimes0 = new com.aliyun.dingtalkbadge_1_0.models.UpdateBadgeCodeUserInstanceRequest.UpdateBadgeCodeUserInstanceRequestAvailableTimes()
                .setGmtStart("2022-11-23 00:00:00")
                .setGmtEnd("2022-11-25 00:00:00");

        Map<String,String> map = new HashMap<>();
        map.put("applicantName","小钉");
        map.put("applyTime","2022-11-23 00:00:00");
        map.put("visitorName","小七");
        map.put("visitorMobile","86-155****3240");

        com.aliyun.dingtalkbadge_1_0.models.UpdateBadgeCodeUserInstanceRequest updateBadgeCodeUserInstanceRequest = new com.aliyun.dingtalkbadge_1_0.models.UpdateBadgeCodeUserInstanceRequest()
                .setCodeId("84a66edcf7065bc19a9169******888210a54611597e54e8_202211231001")
                .setCodeIdentity("DT_VISITOR")
                .setCodeValue("badgeCode_11231001")
                .setStatus("OPEN")
                .setCorpId("ding16b241fd05c8******5d8e4f7c288")
                .setUserCorpRelationType("INTERNAL_STAFF")
                .setUserIdentity("manager7675")
                .setGmtExpired("2022-11-25 00:00:00")
                .setExtInfo(map)
                .setAvailableTimes(java.util.Arrays.asList(
                        availableTimes0
                ));
        try {
            UpdateBadgeCodeUserInstanceResponse updateBadgeCodeUserInstanceResponse = client.updateBadgeCodeUserInstanceWithOptions(updateBadgeCodeUserInstanceRequest, updateBadgeCodeUserInstanceHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(updateBadgeCodeUserInstanceResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

钉工牌实现用户访客码创建

预期效果#

流程简介#

步骤一：创建企业内部应用#

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#

步骤四：获取应用访问凭证accessToken#