摘要：详细介绍如何通过钉钉开放平台API创建待办事项，包括获取Access Token、调用创建待办事项接口及注意事项。

通过API创建钉钉待办事项

      本文介绍如何通过钉钉开放平台API创建待办事项。首先需要注册钉钉开发者账号并创建应用，然后通过应用的AppKey和AppSecret获取Access Token。接下来使用该Token调用钉钉的待办事项创建接口，传入必要的参数如标题、内容、执行人ID和截止时间等。

主要步骤

1. 准备阶段：注册钉钉开发者账号并创建应用。
2. 获取Access Token：通过AppKey和AppSecret调用获取Token接口。
3. 调用创建待办事项接口：使用获取到的Token调用待办事项创建接口，并传递必要参数。

代码示例

import requests
import time

def get_access_token(app_key, app_secret):
    url = f"https://oapi.dingtalk.com/gettoken?appkey={app_key}&appsecret={app_secret}"
    response = requests.get(url)
    if response.status_code == 200:
        data = response.json()
        if data.get("errcode") == 0:
            return data.get("access_token")
    raise Exception("Failed to get access token")

def create_todo(access_token, title, content, executor_userid, due_time, priority=1, source="custom"):
    url = "https://api.dingtalk.com/v1.0/todo/create"
    headers = {
        "Content-Type": "application/json",
        "x-acs-dingtalk-access-token": access_token
    }
    payload = {
        "title": title,
        "content": content,
        "executorUserid": executor_userid,
        "dueTime": due_time,
        "priority": priority,
        "source": source
    }
    response = requests.post(url, headers=headers, json=payload)
    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f"Failed to create todo: {response.text}")

if __name__ == "__main__":
    APP_KEY = "YOUR_APP_KEY"
    APP_SECRET = "YOUR_APP_SECRET"
    access_token = get_access_token(APP_KEY, APP_SECRET)
    title = "测试待办事项"
    content = "这是通过API创建的待办事项"
    executor_userid = "USER_ID"
    due_time = int(time.time() * 1000) + 86400000
    priority = 2
    try:
        result = create_todo(access_token, title, content, executor_userid, due_time, priority)
        print("创建成功:", result)
    except Exception as e:
        print("创建失败:", str(e))

注意事项

• 确保应用拥有足够的权限。
• 正确格式化时间戳。
• 处理可能的错误情况。