在第三方企业应用免登和企业内部应用免登场景中,开发者需要使用本接口通过access_token和免登接口中获取的code来获取用户userid。
POST https://oapi.dingtalk.com/topapi/v2/user/getuserinfo?access_token=ACCESS_TOKEN
在第三方企业应用免登和企业内部应用免登场景中,开发者需要使用本接口通过access_token和免登接口中获取的code来获取用户userid。
实现效果示例如图:
参考文档:通过免登码获取用户信息https://open.dingtalk.com/document/orgapp/obtain-the-userid-of-a-user-by-using-the-log-free
钉钉提供了通过免登码获取用户信息的功能,允许开发者在满足一定条件下获取用户的基本信息。以下是具体的步骤和注意事项:
/topapi/v2/user/getuserinfo
以及/sns/getuserinfo_bycode
等。此外,在使用这些功能时,需要注意以下几点:
通过免登码获取用户信息的接口主要用于第三方企业应用免登和企业内部应用免登场景中,开发者需要使用POST方式调用API,并传入access_token和免登授权码(code)以获取用户的userid。请求地址为:https://oapi.dingtalk.com/topapi/v2/user/getuserinfoQuery参数:• access_token:是,类型为String,例如“6ed1bxxx”,这是调用该API的应用凭证。• code:是,类型为String,例如“bab02f63c1e030fbbxxxx”,免登授权码,五分钟内有效且只能使用一次。返回参数示例:• 请求ID(request_id):String 类型,例如 "e8krly4vyiln"• 返回码(errcode):Number 类型,例如 0• errmsg:String 类型,例如 "ok",对返回码的文本描述内容• result:UserGetByCodeResponse 类型 • userid:String 类型,例如 "user456",用户的userId• device_id:String 类型,例如 "12drtfxxxxx",设备ID• sys:Boolean 类型,表示是否是管理员• sys_level:Number 类型,例如 1,代表用户级别(主管理员、子管理员、老板或其他)• associated_unionid:String 类型,例如 "N2o5U3axxxx",用户关联的unionId• unionid:String 类型,例如 "gliiW002zUxxxx",员工在当前开发者企业账号范围内的唯一标识其中,access_token可以通过针对不同应用类型调用对应的接口获取:• 对于企业内部应用,可通过获取企业内部应用的access_token• 或获取企业内部应用的access_token• 等接口获取。• 对于第三方企业应用,可通过获取第三方企业应用的access_token• 或获取第三方企业应用的access_token• 等接口获取。而免登授权码code的获取方式,请参考以下链接:• 企业内部应用请参考:小程序免登授权码微应用免登授权码• 第三方企业应用请参考:[链24]微应用免登授权码 ,此回答整理自钉群“钉钉开发者社区(互助群)”
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。