钉钉开发-发布待办事项

1,获取access token

1.1 文档:

获取企业内部应用的accessToken

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,  //实际完成时间

        ...

}

猜你喜欢

转载自blog.csdn.net/tirestay/article/details/132529806