ISV应用FAQ

更新时间:2018/07/04 访问次数:16491

Q:调用获取永久授权码接口 , 返回错误{“errcode“: 40078, “errmsg“: “不存在的临时授权码“}?
A: 1.检查临时授权码是否正确。
2.临时授权码 只能使用一次。

Q:ISV申请通讯录权限后,之前已开通套件的企业没有获取通讯的权限。
A:ISV申请通讯录权限,钉钉审核通过后,之前已经开通套件应用的企业,需要先解除该企业的授权,再重新授权,之后再次获取的corptoken才具备访问通讯录的能力。

Q:访问ip不在白名单之中,ip 必须阿里云的服务器吗?
A:因为在白名单没有添加该IP。
1.登录open-dev.dingtalk.com,修改套件,进行白名单的设置。请按下面的链接进行ip白名单地址的配置,注意这里配置的是你的服务器出口ip,不是入口ip。
https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.lhyL7O&treeId=366&articleId=104943&docType=1#s1
2.通过设置白名单接口设置白名单。https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.8u2oyr&treeId=366&articleId=107503&docType=1#s4

Q: 服务端调用注册,添加,删除已通讯录及会话等回调接口,返回错误 {“errcode“:71009,“errmsg“:“返回文本非success“} ?
A: 调用回调接口的时候,钉钉服务器会回调测试回调url,来验证填写的url的合法性,需要您再接收到回调之后返回加密字符串“success”的json数据,才能完成回调。

Q:创建套件的回调URL在外网可以访问,但是创建套件时提示503错误?

A:钉钉开放平台通过回调地址访问不到你的服务器,没有给你推送回调事件,服务器应该没有日志。请参考ISV的Demo的Readme文件。回调地址格式 回调地址: 在你的项目地址后加上/suite/create 。503状态是服务不可用是的一种状态。 请检查服务器是否正常。

Q: 调用钉钉的开放接口,返回“访问的IP不在白名单之内”后,如何配置白名单?
A: 1. 可以进入开发者后台 //open-dev.dingtalk.com/#/suite/detail/1027006?_k=tley8y 。编辑套件修改白名单。
2. 通过接口添加白名单。 请参考文档:https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.CHuDTY&treeId=366&articleId=107503&docType=1#s4

Q:交易型微应用和收费型微应用有哪些区别呢?
A:请参考文档https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7386797.0.0.m6YtPp&source=search&treeId=366&articleId=106623&docType=1#s3。

Q: 不同企业对应不同的CorpID,ISV微应用授权给不同的企业后。ISV微应用如何根据不同的企业获取各自的CorpID?
A: ISV微应用链接地址后添加占位符 $CORPID$ ,在钉钉PC端和移动端点击微应用时,会自动替换占位符为企业的CorpID。这时可以通过链接地址获取CorpID。

Q:请问在开发者平台上修改了主页地址,用户已经安装的微应用主页地址是否会自动更新?何时更新?
A:修改ISV微应用的主页地址,不会立即更新,半小时后生效;退出重新登录可立即生效

Q:企业管理员如何让企业内其他开发成员登录,操作开发者平台的内容,包含查看corpId,corpSecret等信息,以及对套件、应用进行操作?
A:设置该成员为子管理员即可登开发者后台,创建套件管理套件和应用。
设置子管理员,请参考文档:https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.DCvhN3&treeId=385&articleId=106926&docType=1**s2 .
勾选工作台管理权限即可。

Q:“不存在的suiteticket”可能原因?

A:suiteticket是钉钉向isv推送的,推送等待isv返回加密的success字符串。不返回加密的success字符串,会继续保留一段时间,这个一段时间就大概一两天。因为ticket不断产生新的,老的ticket早晚会被lru算法淘汰的,就会报错不存在的suiteticket。

Q:测试企业联调时,取消授权后再添加授权,如何重新获取永久授权码?

A:临时授权码5分钟有效且只能使用一次,测试企业对套件解除授权后,是可以重新发起授权的,重新授权后,套件会收到新推送的临时授权码。

Q:取消授权后一定要重新创建套件吗?无用的套件不能删除吗?

A:不用重新创建套件,套件不允许删除。

Q:钉钉套件ticket推送超过最大次数,是什么原因?

A:每次推送ticket,都希望返回给钉钉服务器加密的“success” .如果你们不返回,那么100次推送失败之后就停止了。显示超过最大推送次数。

Q:isv如何获取企业部门及员工发生的变更?

A:你可以通过监听通讯录及群会话变更事件回调获取企业部门及员工发生的变更,具体文档可以参考回调事件

Q:ISV应用开发中,agentId如何获取?

A:ISV授权整体流程参考文档企业管理员授权ISV完成之后,ISV可以通过接口拉取用户的微应用列表https://oapi.dingtalk.com/service/get_auth_info?suite_access_token=xxxx ,在返回结果中有agentid,标识使用的微应用。

Q:isv套件中后台地址动态解析$CORPID$失败?

A:目前后台地址不是这个逻辑,后台地址不需要这个corpid占位符,做后台免登的时候直接能从接口中得到企业信息的,详细流程参考sso免登文档

Q:套件下创建的微应用是否可删除?

A:目前暂不支持套件微应用的删除。

Q:如何让用户授权可使用用户的电话号码?

A:目前暂不对ISV开放员工手机号码授权接口。

Q:isv如何获取企业部门及员工发生的变更?

A:你可以通过监听通讯录及群会话变更事件回调获取企业部门及员工发生的变更,具体文档可以参考《通讯录及群会话变更事件回调接口》

Q:『计算解密文字错误』怎么解决?

A:查看[加解密文档(https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.Vjge9r&treeId=366&articleId=107524&docType=1)文档。

Q:字符串不匹配?

  • 1.在创建套件过程中、在使用套件回调url接收各种回调处理过程中,会遇到钉钉提示 “返回字符串不匹配”。

  • 2.仔细阅读文档,确认你是按照文档的要求返回的字符串,有的场景要求返回加密“success”,有的地方要返回加密的random对应的key值。

  • 3.确定你的url是不是需要登录的。

  • 4.确定你的url返回的值是json(注意不是返回json.toString),而不是jsonp格式。

  • 5.对于nodejs,要设置 setAutoPadding 为 false,在进行 PKCS7 补全。

  • 6.终极大招:使用postman,既然你能够收到消息并返回,那么请你用log打印出你接接收的参数并贴在postman中。如图:
    image

自己调用自己的接口,看看自己的接口返回了什么。用你的返回解密一下,看看能不能解密出来,是不是按照文档的要求返回的。

Q:如何试用套件?

A:参见套件试用流程

Q:ISV如何在App及后台获取企业及用户相关信息?

A:首先dd.config鉴权后,调用js_api dd.runtime.permission.requestAuthCode 获取code。 然后通过code获取用户信息请参考免登服务, 可以参考文档免登鉴权

Q:ISV接入回调接口没有suiteticket推送,为什么?

A:当你注册套件之后,钉钉服务器会向你填写的回调接口推送suite_ticket。接收到推送之后需要返回加密后的字符串“success”,如果不返回,钉钉服务器将连续推送,直到推送次数超过100次,就不再推送。

此时您需要进入开发者后台,进入套件管理页面,点击『重新推送』按钮,即可重新推送。
repush

Q:ISV套件回调url验证有效性失败?

A:在填写套件回调url的时候,需要ISV填写回调url是可用的。钉钉服务器通过向回调url推送一条『验证回调URL有效性事件』来判断回调url是否可用,具体流程请参见回调接口

Q:不存在的临时授权码?

A:在企业授权ISV开通微应用场景下当您通过临时授权码(tmp_auth_code)和套件token(suite_access_token)去换取永久授权码(permanent_code)之时,需要保证suite_access_token,tmp_auth_code都没有过期。

Q:免登授权失败,返回错误提示 “errorCode 3, 对应企业已经停用某域名下的微应用”。
A: 1.检查该域名下的微应用是否停用。
2.检查corpId是否是当前企业的。查看CorpId请参考文档:
https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.Z1Em8e&&treeId=371&articleId=106926&docType=1。

FAQ

关于此文档暂时还没有FAQ
返回
顶部