Dida365 滴答清单 (Open API)

AI Agent需配置 API Key

滴答清单（Dida365）API 集成，支持自建 OAuth 认证，用于管理任务和项目。当用户需要在滴答清单中创建、更新、完成或组织任务和项目时使用此技能。需在developer.dida365.com 创建应用并配置 DIDA365_CLIENT_ID、DIDA365_CLIENT_SECRET。

任务自动化工具调用

477

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

Dida365 滴答清单#

通过 Dida365 官方 OAuth 认证访问滴答清单 API，支持任务和项目的完整 CRUD 操作。

前置准备#

1. 创建 Dida365 开发者应用#

登录 developer.dida365.com
点击「创建应用」
填写应用名称（任意）
在「回调地址 (Redirect URI)」中添加： http://127.0.0.1:36500/callback
创建完成后，记录下 Client ID 和 Client Secret

2. 配置环境变量#

bash

export DIDA365_CLIENT_ID="YOUR_CLIENT_ID"
export DIDA365_CLIENT_SECRET="YOUR_CLIENT_SECRET"

建议将上述配置写入 ~/.bashrc、 ~/.zshrc 或 .env 文件。

获取 Access Token#

首次使用需要通过 OAuth 授权获取 Access Token。以下流程会启动一个临时本地服务来接收回调。

一键获取 Token（Python）#

bash

python3 << 'PYEOF'
import os, json, http.server, urllib.parse, urllib.request, threading, webbrowser

CLIENT_ID = os.environ["DIDA365_CLIENT_ID"]
CLIENT_SECRET = os.environ["DIDA365_CLIENT_SECRET"]
REDIRECT_URI = "http://127.0.0.1:36500/callback"
TOKEN_FILE = os.path.expanduser("~/.config/dida365/token")
code_holder = {}

class Handler(http.server.BaseHTTPRequestHandler):
    def do_GET(self):
        params = urllib.parse.parse_qs(urllib.parse.urlparse(self.path).query)
        if "code" in params:
            code_holder["code"] = params["code"][0]
            self.send_response(200)
            self.end_headers()
            self.wfile.write(b"Authorization successful! You can close this tab.")
        else:
            self.send_response(400)
            self.end_headers()
            self.wfile.write(b"Missing code parameter.")
    def log_message(self, *args): pass

server = http.server.HTTPServer(("127.0.0.1", 36500), Handler)
thread = threading.Thread(target=server.handle_request)
thread.start()

auth_url = (
    f"https://dida365.com/oauth/authorize"
    f"?client_id={CLIENT_ID}"
    f"&scope=tasks%3Aread+tasks%3Awrite"
    f"&state=random_state_string"
    f"&redirect_uri={urllib.parse.quote(REDIRECT_URI, safe='')}"
    f"&response_type=code"
)
print(f"请在浏览器中打开以下链接并点击授权：\n\n{auth_url}\n")
webbrowser.open(auth_url)

thread.join(timeout=120)
server.server_close()

if "code" not in code_holder:
    print("❌ 超时：未收到授权码，请重试。")
    exit(1)

code = code_holder["code"]
print(f"✅ 已获取授权码，正在交换 Token...")

data = urllib.parse.urlencode({
    "client_id": CLIENT_ID,
    "client_secret": CLIENT_SECRET,
    "code": code,
    "grant_type": "authorization_code",
    "redirect_uri": REDIRECT_URI,
}).encode()

req = urllib.request.Request(
    "https://dida365.com/oauth/token",
    data=data,
    method="POST"
)
req.add_header("Content-Type", "application/x-www-form-urlencoded")
resp = json.load(urllib.request.urlopen(req))
token = resp["access_token"]

os.makedirs(os.path.dirname(TOKEN_FILE), exist_ok=True)
with open(TOKEN_FILE, "w") as f:
    json.dump({"access_token": token}, f)
os.chmod(TOKEN_FILE, 0o600)

print(f"✅ Token 已保存到 {TOKEN_FILE}")
print(f"   有效期约 180 天，请注意及时重新授权。")
PYEOF

Token 存储#

Token 保存在 ~/.config/dida365/token，格式：

json

{
  "access_token": "your_access_token_here"
}

⚠️ 重要提示：

Token 有效期约 180 天
滴答清单当前 API 没有 refresh_token 机制
Token 过期后需重新执行上述授权流程
请妥善保管 Token 文件，不要提交到版本控制系统

Base URL#

text

https://api.dida365.com/open/v1/

认证#

所有请求需要在 Authorization 头中携带 Access Token：

text

Authorization: Bearer {ACCESS_TOKEN}

快速测试#

bash

# 读取 Token 并列出项目
python3 << 'PYEOF'
import os, json, urllib.request

token_file = os.path.expanduser("~/.config/dida365/token")
with open(token_file) as f:
    token = json.load(f)["access_token"]

req = urllib.request.Request("https://api.dida365.com/open/v1/project")
req.add_header("Authorization", f"Bearer {token}")
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2, ensure_ascii=False))
PYEOF

API 参考#

项目操作#

列出所有项目

text

GET /open/v1/project

响应示例：

json

[
  {
    "id": "6984773291819e6d58b746a8",
    "name": "📝 收集箱",
    "sortOrder": 0,
    "viewMode": "list",
    "kind": "TASK"
  },
  {
    "id": "6984773291819e6d58b746a9",
    "name": "🏠 个人",
    "sortOrder": -1099511627776,
    "viewMode": "list",
    "kind": "TASK"
  }
]

获取项目及任务

text

GET /open/v1/project/{projectId}/data

响应示例：

json

{
  "project": {
    "id": "69847732b8e5e969f70e7460",
    "name": "📋 工作",
    "sortOrder": -3298534883328,
    "viewMode": "list",
    "kind": "TASK"
  },
  "tasks": [
    {
      "id": "69847732b8e5e969f70e7464",
      "projectId": "69847732b8e5e969f70e7460",
      "title": "完成报告",
      "content": "季度总结报告",
      "priority": 0,
      "status": 0,
      "tags": [],
      "isAllDay": false
    }
  ],
  "columns": [
    {
      "id": "69847732b8e5e969f70e7463",
      "projectId": "69847732b8e5e969f70e7460",
      "name": "待办",
      "sortOrder": -2199023255552
    }
  ]
}

创建项目

text

POST /open/v1/project
Content-Type: application/json

{
  "name": "我的新项目",
  "viewMode": "list"
}

响应示例：

json

{
  "id": "69870cbe8f08b4a6770a38d3",
  "name": "我的新项目",
  "sortOrder": 0,
  "viewMode": "list",
  "kind": "TASK"
}

viewMode 选项：

list - 列表视图
kanban - 看板视图
timeline - 时间线视图

删除项目

text

DELETE /open/v1/project/{projectId}

成功时返回空响应（状态码 200）。

任务操作#

获取任务

text

GET /open/v1/project/{projectId}/task/{taskId}

响应示例：

json

{
  "id": "69847732b8e5e969f70e7464",
  "projectId": "69847732b8e5e969f70e7460",
  "sortOrder": -1099511627776,
  "title": "任务标题",
  "content": "任务描述/备注",
  "timeZone": "Asia/Shanghai",
  "isAllDay": true,
  "priority": 0,
  "status": 0,
  "tags": [],
  "columnId": "69847732b8e5e969f70e7461",
  "etag": "2sayfdsh",
  "kind": "TEXT"
}

创建任务

text

POST /open/v1/task
Content-Type: application/json

{
  "title": "新任务",
  "projectId": "6984773291819e6d58b746a8",
  "content": "任务描述",
  "priority": 0,
  "dueDate": "2026-03-15T10:00:00+0000",
  "isAllDay": false
}

响应示例：

json

{
  "id": "69870cb08f08b86b38951175",
  "projectId": "6984773291819e6d58b746a8",
  "sortOrder": -1099511627776,
  "title": "新任务",
  "timeZone": "Asia/Shanghai",
  "isAllDay": false,
  "priority": 0,
  "status": 0,
  "tags": [],
  "etag": "gl7ibhor",
  "kind": "TEXT"
}

优先级值：

0 - 无
1 - 低
3 - 中
5 - 高

更新任务

text

POST /open/v1/task/{id}
Content-Type: application/json

{
  "id": "69870cb08f08b86b38951175",
  "projectId": "6984773291819e6d58b746a8",
  "title": "更新后的任务标题",
  "priority": 1
}

响应示例：

json

{
  "id": "69870cb08f08b86b38951175",
  "projectId": "6984773291819e6d58b746a8",
  "title": "更新后的任务标题",
  "priority": 1,
  "status": 0,
  "etag": "hmb7uk8c",
  "kind": "TEXT"
}

完成任务

text

POST /open/v1/project/{projectId}/task/{taskId}/complete

成功时返回空响应（状态码 200）。

删除任务

text

DELETE /open/v1/project/{projectId}/task/{taskId}

成功时返回空响应（状态码 200）。

任务字段说明#

字段类型说明idstring任务 IDprojectIdstring所属项目 IDtitlestring任务标题contentstring任务描述/备注（支持 Markdown）priorityinteger优先级：0=无, 1=低, 3=中, 5=高statusinteger状态：0=进行中, 2=已完成dueDatestring截止日期（ISO 8601 格式）startDatestring开始日期（ISO 8601 格式）isAllDayboolean是否全天任务timeZonestring时区（如 "Asia/Shanghai"）tagsarray标签列表columnIdstring看板列 ID（看板视图时使用）sortOrdernumber项目内的排序kindstring任务类型："TEXT"、"CHECKLIST"

代码示例#

Python（requests）#

python

import os, json

# 读取 Token
with open(os.path.expanduser("~/.config/dida365/token")) as f:
    token = json.load(f)["access_token"]

headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}

# 列出所有项目
import requests
resp = requests.get("https://api.dida365.com/open/v1/project", headers=headers)
projects = resp.json()
print(json.dumps(projects, indent=2, ensure_ascii=False))

# 创建任务
resp = requests.post("https://api.dida365.com/open/v1/task", headers=headers, json={
    "title": "新任务",
    "projectId": "YOUR_PROJECT_ID",
    "content": "通过 API 创建的任务",
    "priority": 3,
    "dueDate": "2026-04-01T09:00:00+0800"
})
print(resp.json())

# 完成任务
resp = requests.post(
    "https://api.dida365.com/open/v1/project/YOUR_PROJECT_ID/task/TASK_ID/complete",
    headers=headers
)
print(f"状态: {resp.status_code}")

JavaScript（fetch）#

javascript

import { readFileSync } from "fs";

// 读取 Token
const { access_token: token } = JSON.parse(
  readFileSync(process.env.HOME + "/.config/dida365/token", "utf-8")
);

const headers = {
  Authorization: `Bearer ${token}`,
  "Content-Type": "application/json",
};

// 列出所有项目
const projects = await fetch("https://api.dida365.com/open/v1/project", {
  headers,
}).then((r) => r.json());
console.log(projects);

// 创建任务
const task = await fetch("https://api.dida365.com/open/v1/task", {
  method: "POST",
  headers,
  body: JSON.stringify({
    title: "新任务",
    projectId: "YOUR_PROJECT_ID",
    content: "通过 API 创建的任务",
    priority: 3,
  }),
}).then((r) => r.json());
console.log(task);

// 完成任务
await fetch(
  `https://api.dida365.com/open/v1/project/YOUR_PROJECT_ID/task/TASK_ID/complete`,
  { method: "POST", headers }
);

curl 示例#

bash

# 读取 Token
TOKEN=$(cat ~/.config/dida365/token | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")

# 列出项目
curl -s -H "Authorization: Bearer $TOKEN" https://api.dida365.com/open/v1/project | python3 -m json.tool

# 创建任务
curl -s -X POST https://api.dida365.com/open/v1/task \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"测试任务","projectId":"YOUR_PROJECT_ID"}' | python3 -m json.tool

注意事项#

Open API 仅提供任务和项目的访问
习惯、专注/番茄钟等功能不通过 Open API 提供
任务 status 值：0 = 进行中，2 = 已完成
优先级值：0 = 无，1 = 低，3 = 中，5 = 高
日期使用 ISO 8601 格式带时区偏移（如 2026-03-15T10:00:00+0800）
项目的 viewMode 选项： list、 kanban、 timeline
columns 字段用于看板视图的列定义
Token 有效期约 180 天，无 refresh_token，过期需重新授权

错误处理#

状态码含义处理方式400请求参数错误检查请求体格式和必填字段401Token 无效或已过期重新执行 OAuth 授权流程获取新 Token404资源未找到确认项目 ID / 任务 ID 是否正确429请求频率超限降低请求频率，等待后重试5xx服务端错误稍后重试

故障排除#

Token 过期（401 错误）：

bash

# 重新运行授权脚本获取新 Token
# 参考上方「获取 Access Token」章节

检查 Token 有效性：

bash

TOKEN=$(cat ~/.config/dida365/token | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")
curl -s -o /dev/null -w "%{http_code}" -H "Authorization: Bearer $TOKEN" https://api.dida365.com/open/v1/project
# 返回 200 表示有效，返回 401 表示已过期

环境变量未设置：

bash

echo $DIDA365_CLIENT_ID
echo $DIDA365_CLIENT_SECRET

资源#

捕获经验教训、错误及修正内容，以实现持续改进。适用于以下场景：（1）命令或操作意外失败；（2）用户纠正Claude（如“不，那不对……”“实际上……”）；（3）用户请求的功能不存在；（4）外部API或工具出现故障；（5）Claude发现自身知识已过时或不正确；（6）针对重复性任务发现了更优方法。同时，在执行重大任务前应回顾已积累的经验教训。

AI Agent

★ 4116↓ 83.7万3 个月前更新

场景驱动+关键词双模式技能发现工具。当用户用自然语言描述场景/需求（如"我想做一个海报""帮我分析股票"），或明确说"安装技能/find skills/找个skill"时，自动从官方内置、本地已安装、SkillHub、虾评、GitHub、ClawHub 六层联合搜索并推荐最合适的技能，支持一键安装。已完全替代官方...

AI Agent

★ 1482↓ 54.5万3 个月前更新

自我反思+自我批评+自我学习+自组织记忆。智能体评估自身工作、发现错误并持续改进。

AI Agent

★ 1402↓ 32.4万3 个月前更新

Dida365 滴答清单 (Open API)

Dida365 滴答清单#

前置准备#

1. 创建 Dida365 开发者应用#

2. 配置环境变量#

获取 Access Token#

一键获取 Token（Python）#

Token 存储#

Base URL#

认证#

快速测试#

API 参考#

项目操作#

列出所有项目

获取项目及任务

创建项目

删除项目

任务操作#

获取任务

创建任务

更新任务

完成任务

删除任务

任务字段说明#

代码示例#

Python（requests）#

JavaScript（fetch）#

curl 示例#

注意事项#

错误处理#

故障排除#

资源#

self-improving agent

Find Skills

Self-Improving + Proactive Agent

Agent Browser

Skill Vetter

ontology

Dida365 滴答清单 (Open API)

Dida365 滴答清单#

前置准备#

1. 创建 Dida365 开发者应用#

2. 配置环境变量#

获取 Access Token#

一键获取 Token（Python）#

Token 存储#

Base URL#

认证#

快速测试#

API 参考#

项目操作#

列出所有项目

获取项目及任务

创建项目

删除项目

任务操作#

获取任务

创建任务

更新任务

完成任务

删除任务

任务字段说明#

代码示例#

Python（requests）#

JavaScript（fetch）#

curl 示例#

注意事项#

错误处理#

故障排除#

资源#

相关推荐

self-improving agent

Find Skills

Self-Improving + Proactive Agent

Agent Browser

Skill Vetter

ontology