开放平台FAQ
Q：ISV租户是开发商申请，还是政府单位申请的？
A：一般都为开发商申请。
Q：开发商ISV入驻申请进度？
A：一般为2个工作日，提交申请2个工作日后未收到成功短信，需要联系技术支持同学咨询进度。
Q：超管账号是否可以换人？
A：暂时不行。
Q：开放平台应用配置里离线包如何选择？
A：使用到mpass离线包选择是，反之选择否，不了解mpass离线包选择否。
Q：开放平台应用配置里应用配置时统建（省市区）与非统建的区别？
A：统建应用可以在发布应用时发布到统建模块，非统建应用不可发布到统建模块。
Q：手机号注册成为isv后，无法添加该手机号人员？
A：isv账号属于超管类型账号，是权限类型账号，没有角色属性，添加人员需要使用新的手机号。
Q：应用管理者无法添加人员？
A：所添加的人员必须与应用管理者在同一租户下才可添加。
Q：添加应用管理者时，下拉框没有内容？
A：该输入框为搜索型输入框，需要输入被添加者的名字才能进行搜索，搜索无结果时，可在管理工作台添加人员。
Q：应用发布后，客户端工作台不显示应用？
A：发布应用之后在 管理工作台-权限管理-应用授权-用户工作台-选择工作台-配置-添加应用。
或者管理工作台上面”用户工作台”标签页直接进入用户工作台。
用户工作台添加应用并且发布工作台后才会展示应用。并不是应用发布后，客户端工作台就会展示应用。
Q：客户端工作台无法打开显示网络请求错误?
A：检查是否是子账号登录，超管账号移动端是没法打开工作台的。
Q：专有钉钉相关地址链接？
A：
专有钉钉开放平台官网地址：https://openplatform-portal.dg-work.cn/portal/#/
专有钉钉开发者后台地址：https://openplatform-portal.dg-work.cn/devPage/#/myApp
专有钉钉管理工作台地址：https://console.dg-work.cn/
Q：客户端打开工作台显示获取数据失败，请点击重试？
A：请检查工作台管理后台是否有创建工作台。
两种方式进入工作台：点击标签页‘用户工作台‘；或者应用授权-进入工作台，进行配置。
如果没有用户工作台入口，请检查是否有工作台相关权限。
具体参考-应用上架工作台：https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=ksrm&slug=xggle5
Q：应用已经发布了，但配置工作台的时候搜索不到这个应用？
A：请检查该应用的应用配置中是否配置了移动端或者pc端首页链接。
工作台选择应用的时候是会根据配置的这个地址来展示客户端应用以及pc端应用的。
Q：工作人员accountId即账号(UID)怎么获取？
A：accountId=账号(UID)，可以通过接口获取或者管理工作台后台查看：
1. 根据authCode换取用户信息，/rpc/oauth2/dingtalk_app_user.json，接口可以获取accountId
2. 也可以通过员工 Code 列表获取员⼯账号 ID（/mozi/employee/listEmployeeAccountIds）：
3. 管理工作台-组织与人员管理，点击对应人员的详情，可以查看uid，如下图
Q：应用的可见范围在哪设置？
A：应用可见范围即应用使用范围，在控制台-应用管理界面进行设置。可参考以下截图：
Q：专有钉钉扫码提示“二维码解析失败”？
A：专有钉钉自带的扫一扫功能，目前只支持扫固定的二维码。如需支持扫其他的二维码，需要进行扫码白名单配置。
配置路径：控制台-配置中心 - 扫码白名单配置
配置规则：域名在“.”前面加上“\” 在末尾加上“/.”即可
例如”^http?://xxxxxx\.xxxxxx.xxxxx\.xxxxx\.xxxx/.“
服务端FAQ
Q：怎样获得租户ID？
A：
1.通过获取用户详情/rpc/oauth2/dingtalk_app_user.json这个接口返回的realmId即是租户ID。
2.进入管理工作台，任意界面右击，查看网页源码，其中realmId即是租户ID
Q：gettoken.json报错:User not authorized to operate on the specified ？
A：专有钉钉环境 在我的应用 接口权限-开通企业内应用免登权限，其他环境联系技术支持同学开通相应权限。
Q：调用接口报错：InvalidTimeStamp ？
A：客户端时间戳非法。网关服务端最大接受客户端时间误差在15分钟。请检查服务器时间是否跟北京时间相差过大。
Q：/mozi/employee/listEmployeesByCodes或者/mozi/employee/listEmployeeAccountIds或者员工code列表多个employeeCode如何传参?
A：for (String code : employeeCodes) { postClient.addParameter(“employeeCodes”, code); }
Q：/mozi/employee/listEmployeesByCodes 员工code列表最多支持传多少？
A：传100个，批量查询一般情况下默认100。
Q：通讯录相关接口没有获取数据的权限？/应用通讯录范围查询/配置?
A：可查看【应用访问通讯录范围】设置。
1）控制台-应用管理中查看设置。如下图
2）或者应用开发-应用权限中查看设置。如下图
Q：专有钉钉域名DomainName是什么？
A：专有钉钉域名为：openplatform.dg-work.cn
Q：专有钉钉调用接口报错：Forbidden，User not authorized to operate on the specified resource.
A：此报错通常是调用的接口没有开通权限。进入对应的应用-应用权限，查看调用的接口对应的权限是否开通。
Q： 获取组织目录树/ 组织 Code列表organizationCodes怎么获取？
A：
1、根据获取通讯录权限范围接口获取应用可访问顶层组织code
2、根据分页获取下⼀级组织 Code 列表 一层一层获取组织 Code 列表
3、根据组织 Code 列表查询详情（批量）/根据组织code查询详情（单个） 完善组织信息
Q：为什么获取不到员工手机号和短号？
A：基于安全考虑，目前暂时无法提供获取人员信息返回手机号的功能。
Q：哪个接口可以获取到用户头像？
A：根据员工 Code 查询详情，一个单个查询，一个批量查询，返回的govEmpAvatar字段就是头像。
接口如下，点击即可跳转：
根据员工 Code 查询详情
批量根据员⼯ Code 查询详情
Q：SDK下载链接？
A：SDK下载：https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=gjyzy&slug=st5ct2
Q：小程序/H5应用如何上传文件到第三方的存储空间里？
A：上传文件后，调用服务端接口‘媒体文件下载’转存。
Q：获取员工code接口?
A：
1.可以通过获取用户详情接口获取员工code。
2.可以通过组织code获取批量获取组织下员工code（分页查询组织下的员⼯ Code）：
Q：获取员工所在部门信息？
A：
1、获取通讯录用户信息—-根据员工code获取员工的任职 查询组织code
2、获取通讯录部门信息—-根据组织code查询详情
https://openplatform-portal.dg-work.cn/#/docs?apiType=serverapi&docKey=2674856 （单个） https://openplatform-portal.dg-work.cn/#/docs?apiType=serverapi&docKey=2674850 （批量）
Q：通过用户的employeeCode能不能获取到用户所在机构？
A：
1.根据员工code获取员工的任职，先通过这个接口获取组织code
2.根据组织Code查询详情，再通过此接口查组织code的详情
https://openplatform-portal.dg-work.cn/#/docs?apiType=serverapi&docKey=2674856 （单个） https://openplatform-portal.dg-work.cn/#/docs?apiType=serverapi&docKey=2674850 （批量）
Q：H5应用怎么判断是哪个app打开?
A：
1.通过useragent TaurusApp 来判断。专有钉钉是 saas 。
2.或者通过前端接口getUserAgent获取应用相关信息UA 。
Q：接口报错：SignatureDoesNotMatch
A：请检查域名配置是否正确，不同环境对应不同域名：专有钉钉域名：openplatform.dg-work.cn
或者AK/SK的SK配置不正确
Q：宜搭接口使用?
A：1.使用宜搭接口需要开通租户宜搭权限,提供租户ID给群内技术支持人员。
2.进入宜搭后台创建流程后使用相关接口
Q：内网穿透相关文档?
A：内网穿透相关文档：https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=gjyzy&slug=ib188n
Q：根据手机号码获取人员编码报错：appTenantValidateError？
A：1.检查AK/SK以及域名是否配置正确，是否配置的对应环境上应用的AK/SK以及对应环境的域名。
2.检查该接口传入的参数tenantId租户ID是否正确。
Q： 组织code列表多个organizationCode如何传参?
A：for (String code : organizationCodes) {
postClient.addParameter(“organizationCodes”, code);
}
Q：C#，组织code/人员code多值传参？
A：1.实现原理为：list里每一条数据都作为一个单独的参数上传重载方法是为了字典Dictionary循
环添加时重复Key报错
2.创建类实现接口IEqualityComparer
publicboolEquals(stringx,stringy)
{
returnx!=y;
}
publicintGetHashCode(stringobj)
{
returnobj.GetHashCode();
}
重载这两个方法
3.传递List集合
publicstaticYg_ViewGetYgView(List
{
//UTF8Encoding
Dictionary
重载方法的类,创建匿名对象如newTest());
for(inti=0;i
dics.Add(“employeeCodes”,employeeCodes[i]);;
}
dics.Add(“tenantId”,realmId);
stringa=DDHelp.GetPost(dics,”/mozi/employee/listEmployeesByCodes”);
Yg_Viewyg_view=JsonHelper.JsonToObject
returnyg_view;
}
Q：工作消息通知报错：msgApp不可用？
A：工作通知消息体可能无法解析，可参照工作通知接口的demo。
Q：接口调用报错：访问IP不在白名单中
A：请检查应用配置-服务器出口IP设置是否包含报错的request ip。
服务器出口IP是调用专有钉钉服务端API时的合法IP列表，多个IP请以“;”隔开,支持带的IP段,后面不能再加数字。
接口通用FAQ
Q：专有钉钉有移动端调试工具吗，移动端如何调试？
A：专有钉钉没有提供专门的H5应用的调试工具，需要开发者自行百度选择自己熟悉的调试工具即可。小程序是有专门的开发工具的在开发指南里面。
Q：请求报错：org.joda.time.ReadableInstant
A：请在pom.xml中添加如下内容：
Q：免登流程？
A：免登参考：https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=kfzn&slug=bfno8h
H5微应用FAQ
Q： h5微应用怎么监听导航左侧按钮的返回事件？
A：监听导航左上角返回按钮的点击事件，可以使用专有钉钉客户端提供的 JSAPI：back，同时back也可监听安卓物理返回键。
Q：前端jsapi调用报错：无调用权限？
A：是否需要鉴权是https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=kfzn&slug=qw0y0e
Q：前端jsapi鉴权失败，报错：应用标志和ticket不匹配？
A：1.应用标志和ticket不匹配：需要检查AK/SK以及域名是否正确。步骤如下：
1）检查初始化参数的AccessKey、SecretKey、DomainName是否为对应环境的域名以及应用的AK/SK;
2）/gettoken.json的入参appkey、appsecret也为应用的AK/SK，跟初始化的一致
Q：前端的JSAPI版本号查看?
A：https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=kfzn&slug=knqb1i
Q：使用Vue开发的多路由H5应用中，不同页面的导航中调用扫一扫，页面崩溃？
A：单页应用设置右上角菜单的时候，在每个单页代码初始化的地方监听事件 optionMenu ,离开该页面时需要销毁监听的 optionMenu 事件。
Q：createVideoMeeting 在专有钉钉环境报：’功能尚未启用‘？
A：createVideoMeeting 在专有钉钉环境默认不启用的。如果需要启用，提供租户id，联系群内技术支持。
Q：文件预览的时候提示“不支持文件类型”？
A：检查fileName是否有带文件后缀。
Q：toast弱提示ios11显示后一直存在？
A：设置duration，注意值为Number，单位为‘秒’。例如：duration:3
Q：getAuthCode入参corpId 去哪里取？
A：该参数不用传，因为调的这个接口端包装的，端上会用当前登录者的身份去获取authCode如果想获取corpId：
1.通过获取用户详情/rpc/oauth2/dingtalk_app_user.json这个接口返回的realmId即是租户ID。
2.进入管理工作台，任意界面右击，查看网页源码，其中realmId即是租户ID
Q：getGeolocation接口，iOS返回参数只有3个，没有返回完整？
A：入参withReGeocode改成true能返回全部参数。
**Q：
A：可能是isv的连接是非授信的。可以放在安卓钉钉中打开看下是否有ssl err的提示，ssl err的问题isv自行解决。
Q：H5代码更新了，在专有钉钉app上没有更新到最新的代码。还是之前的代码？
A：可以从前端代码解决在index中加代码：
小程序FAQ
Q：小程序getAuthCode接口报错：[API_getAuthCode_error] 无效参数
A：小程序getAuthCode接口请在真机调试（IDE右上角），模拟器无法获取，会报错无效参数
https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=kfzn&slug=emgdx1
Q：小程序报错：ReferenceError: dd is not defined？
A：请在页面引入dd。
具体参考：小程序API使用说明
Q：小程序真机调试扫报错，应用更新错误（50002）？
A：排查下白名单是否配置错误。白名单填的是用户的uid, 检查下是否是当前环境，当前账号的uid.每个uid之间用逗号（,）隔开，注意不要有空格。白名单设置参考：https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=kfzn&slug=emgdx1
Q：小程序开发者工具中显示tab选项卡 真机预览不显示？
A：查看配置：显示底部导航栏，选择为是，如果本来为是，直接再保存一下让其生效。
Q：工作通知跳转小程序？
A：工作通知链接跳转到小程序 ： taurus://taurusclient/action/open_tiny_app?appId=(小程序的appId)&page=pages/index/index?query=(携带的参数)
PS: appId在ide详情中查看，和appKey是两码事
Q：小程序真机调试可以，发布到工作台后一直loading加载不出来？
A：先检查下小程序的首页路径是否为pages/index/index. 这个目前首页是不支持修改的。
Q：小程序分享onShareAppMessage分享后参数在页面中取不到？
A：onShareAppMessage分享的参数，需要在App的onLaunch中取，demo:
App({
onLaunch(options) {
my.alert({ content: App onLaunch with query: ${JSON.stringify(options)} });
},
});
其他问题
Q：iOS 键盘与组件交互异常：创建了一个input，textarea输入框。真机上，只要点输入框，弹出键盘，输入文字时，文字不知位移到某个部位。 落下键盘才显示输入的文字。
A：对于需要启动键盘的组件，如 input、textarea 等，目前默认使用的是原生键盘。如果键盘和组件的交互存在异常，可在组件中添加 enableNative=”{{false}}”属性（如下所示），即可恢复到使用 WKWebview 的键盘。同时由于使用的是系统键盘，也就不能使用 mPaaS 提供的 Native 键盘相关功能，键盘相关目前不再专门适配，如有交互异常问题请使用该方式进行处理。
若有收获，就点个赞吧
0 人点赞
