钉钉开放平台接口文档0201

目录建立连接..........................................................................................................................................2主动调用...................................................................................................................................3获取AccessToken.............................................................................................................3回调模式...................................................................................................................................5管理多媒体文件..............................................................................................................................5上传媒体文件.........................................................................................................................12获取媒体文件.........................................................................................................................13发送消息........................................................................................................................................15发送接口说明.........................................................................................................................15消息类型及数据格式.............................................................................................................16text消息.........................................................................................................................16image消息......................................................................................................................17voice消息.......................................................................................................................17video消息.......................................................................................................................18file消息...........................................................................................................................19办公消息.........................................................................................................................20免登服务........................................................................................................................................21使用标准OAUTH2.0HTTP302跳转方式获取CODE...........................................................22通过CODE换取用户身份......................................................................................................23获取jsapi_ticket.............................................................................................................................24欢迎你，钉钉微应用的开发者，我们很期待你成为钉钉微应用的开发者；微应用是钉钉为连接企业办公打造的移动入口，通过微应用你可以将企业的业务审批，内部系统，生成，协作，管理，上下游沟通连接到钉钉，更简单和低成本实现企业移动化；结合钉钉的基础通信能力，让企业应用更活跃，员工更高效，移动化成本更低。此文档很适合于a)企业的IT部，了解钉钉如何连接你所在企业的办公。b)软件开发服务商，了解如何通过钉钉为您的客户提供定制的企业办公软件，提升你的服务价值。建立连接你可以使用以下三种方式，将钉钉微应用连接到你的企业应用：1、企业应用服务器调用钉钉开放平台提供的接口，以钉钉微应用的身份给企业用户的钉钉账号推送消息，以下称主动调用模式。2、钉钉开放平台把钉钉用户发送的消息或触发的事件推送给企业应用服务器，由企业应用处理，以下称回调模式(暂未开放)。3、钉钉用户在使用企业提供的微应用H5页面时，该页面可以调用钉钉提供的原生接口，使用钉钉开放的终端能力，以下称JSAPI模式。主动调用当企业应用服务器调用钉钉开放平台接口时，需使用https协议、Json数据格式、UTF8编码，访问域名为，数据包不需要加密。在每次主动调用钉钉开放平台接口时需要带上AccessToken参数。AccessToken参数由CorpID和Secret换取。CorpID是企业在钉钉中的标识，每个企业拥有一个唯一的CorpID；Secret是企业每个应用的凭证密钥。CorpID及Secret可以在钉钉为企业提供的管理后台中找到，由钉钉自动分配。获取AccessTokenAccessToken是企业访问钉钉开放平台接口的全局唯一票据，调用接口时需携带AccessToken。AccessToken需要用CorpID和Secret来换取，不同的Secret会返回不同的AccessToken。正常情况下AccessToken有效期为7200秒，有效期内重复获取返回相同结果，并自动续期。请求说明Https请求方式:GET=id&corpsecret=secrect参数说明参数必须说明corpid是企业Idcorpsecret是企业应用的凭证密钥返回说明a)正确的Json返回结果:{errcode:0,errmsg:okaccess_token:fw8ef8we8f76e6f7s8df8s,}参数说明errcode错误码errmsg错误信息access_token获取到的凭证b)错误的Json返回示例:{errcode:43003,errmsg:requirehttps}回调模式(暂未开放)暂未开放。管理通讯录管理部门获取部门列表请求说明Https请求方式:GET=ACCESS_TOKEN参数说明参数必须说明access_token是调用接口凭证返回结果{errcode:0,errmsg:ok,department:[{id:2,name:来往事业部,parentid:1},{id:3name:服务端开发组,parentid:2}]}参数说明errcode返回码errmsg对返回码的文本描述内容department部门列表数据。以部门的order字段从小到大排列id部门idname部门名称parentid父亲部门id。根部门为1管理成员获取成员请求说明Https请求方式:GET=ACCESS_TOKEN&userid=zhangsan参数说明参数必须说明access_token是调用接口凭证userid是员工在企业内的UserID，企业用来唯一标识用户的字段。返回结果{errcode:0,errmsg:ok,userid:zhangsan,name:张三,department:[1,2],position:工程师,mobile:[phone],email:[e-mail],openId:HUHIujjg8*7,avatar::{attrs:[{name:爱好,value:旅游},{name:卡号,value:1234567234}]}}参数说明errcode返回码errmsg对返回码的文本描述内容userid员工UserID。对应管理端的帐号name成员名称department成员所属部门id列表position职位信息mobile手机号码email邮箱openId钉钉开放平台IDavatar头像url。extattr扩展属性获取部门成员请求说明Https请求方式:GET=ACCESS_TOKEN&department_id=1&fetch_child=0参数说明参数必须说明access_token是调用接口凭证department_id是获取的部门idfetch_child否1/0：是否递归获取子部门下面的成员返回结果{errcode:0,errmsg:ok,userlist:[{userid:zhangsan,name:张三}]}参数说明errcode返回码errmsg对返回码的文本描述内容userlist成员列表userid员工UserID。对应管理端的帐号name成员名称获取部门成员(详情)请求说明Https请求方式:GEThttps:/