1,获取access token
1.1 文档:
1.2 代码:
请求:
POST /v1.0/oauth2/accessToken HTTP/1.1
Host:api.dingtalk.com
Content-Type:application/json{
"appKey" : "String",
"appSecret" : "String"
}
返回:
HTTP/1.1 200 OK
Content-Type:application/json
{
"accessToken" : "fw8ef8we8f76e6f7s8dxxxx",
"expireIn" : 7200
}
获得access_token:fw8ef8we8f76e6f7s8dxxxx
2,获取用户的union id
2.1 文档:
2.2 代码:
请求:
POST https://oapi.dingtalk.com/topapi/v2/user/getuserinfo?access_token={accessToken}
Content-Type:application/json
{
"code":"免登码" //参考 客户端获取免登码
}
POST https://oapi.dingtalk.com/topapi/v2/user/getuserinfo?
access_token=fw8ef8we8f76e6f7s8dxxxx
Content-Type:application/json
{
"code":"bab02f63c1e030fbbxxxx"
}
返回:
{
"errcode": 0,
"result": {
"associated_unionid": "N2o5U3axxxx",
"unionid": "gliiW0piiii02zBUjUxxxx",
"device_id": "12drtfxxxxx",
"sys_level": 1,
"name": "张xx",
"sys": true,
"userid": "userid123"
},
"errmsg": "ok"
}
获得union id: gliiW0piiii02zBUjUxxxx
3, 创建待办
3.1 文档:
3.2 代码:
请求:
POST /v1.0/todo/users/{unionId}/tasks?operatorId=String HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:{accessToken}
Content-Type:application/json
POST /v1.0/todo/users/gliiW0piiii02zBUjUxxxx/tasks?operatorId=String HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:fw8ef8we8f76e6f7s8dxxxx
Content-Type:application/json
返回:
{
"id" : "OPJpwtwPVNGIFKURjrzd",
"subject" : "接入钉钉待办",
...
}
获得任务ID: OPJpwtwPVNGIFKURjrzd
4,查询待办
4.1 文档:
4.2 代码:
请求:
GET /v1.0/todo/users/{unionId}/tasks/{taskId} HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:String
Content-Type:application/json
GET /v1.0/todo/users/gliiW0piiii02zBUjUxxxx/tasks/OPJpwtwPVNGIFKURjrzd HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:fw8ef8we8f76e6f7s8dxxxx
Content-Type:application/json
返回:
{
"id" : "OPJpwtxxxx",
"subject" : "接入钉钉待办", //标题
"done" : true, //状态
"startTime" : 1617675000000, //计划开始时间
"dueTime" : 1617675000000, //计划完成时间
"finishTime" : 1617675000000, //实际完成时间
...
}