Asana

简介

Asana 的 API 管理项目、任务和团队——用 OAuth 2.0 或个人访问令牌。无认证请求返回 401（已实测）。

快速开始

我（替换 YOUR_TOKEN）：

curl "https://app.asana.com/api/1.0/users/me" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "data": {
    "gid": "12345",
    "name": "John Doe",
    "email": "john@example.com",
    "resource_type": "user"
  }
}

项目中的任务：

curl "https://app.asana.com/api/1.0/projects/PROJECT_GID/tasks?opt_fields=name,completed" \
  -H "Authorization: Bearer YOUR_TOKEN"

认证方式

• 个人访问令牌：Asana → My Profile → Settings → Apps → Personal access tokens。
• 或应用走 OAuth 2.0。
• 通过 Authorization: Bearer YOUR_TOKEN 携带（缺失 → 401，已实测）。

速率限制与注意事项

• 限流按工作区/组织（每个用户令牌约 150 次/分钟——以文档为准）。
• API v1.0 稳定，用 opt_fields 控制响应。
• 资源：用户、项目、任务、分组、团队、工作区。
• 每个资源的稳定标识符是 gid。

常见问题

Asana API 免费吗？ API 访问随任意套餐免费（有限流）。

如何获取令牌？ My Profile → Settings → Apps → Personal access tokens。

base URL 是什么？ app.asana.com/api/1.0。