Fresh start - excluded large ROM JSON files
This commit is contained in:
117
skills/api-gateway/references/ticktick.md
Normal file
117
skills/api-gateway/references/ticktick.md
Normal file
@@ -0,0 +1,117 @@
|
||||
# TickTick Routing Reference
|
||||
|
||||
**App name:** `ticktick`
|
||||
**Base URL proxied:** `api.ticktick.com`
|
||||
|
||||
## API Path Pattern
|
||||
|
||||
```
|
||||
/ticktick/open/v1/{resource}
|
||||
```
|
||||
|
||||
## Common Endpoints
|
||||
|
||||
### List Projects
|
||||
```bash
|
||||
GET /ticktick/open/v1/project
|
||||
```
|
||||
|
||||
### Get Project with Tasks
|
||||
```bash
|
||||
GET /ticktick/open/v1/project/{projectId}/data
|
||||
```
|
||||
|
||||
Returns project details along with tasks and columns.
|
||||
|
||||
### Create Project
|
||||
```bash
|
||||
POST /ticktick/open/v1/project
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"name": "My Project",
|
||||
"viewMode": "list"
|
||||
}
|
||||
```
|
||||
|
||||
**viewMode options:** `list`, `kanban`, `timeline`
|
||||
|
||||
### Delete Project
|
||||
```bash
|
||||
DELETE /ticktick/open/v1/project/{projectId}
|
||||
```
|
||||
|
||||
### Get Task
|
||||
```bash
|
||||
GET /ticktick/open/v1/project/{projectId}/task/{taskId}
|
||||
```
|
||||
|
||||
### Create Task
|
||||
```bash
|
||||
POST /ticktick/open/v1/task
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"title": "New task",
|
||||
"projectId": "PROJECT_ID",
|
||||
"content": "Task description",
|
||||
"priority": 0,
|
||||
"dueDate": "2026-02-15T10:00:00+0000",
|
||||
"isAllDay": false
|
||||
}
|
||||
```
|
||||
|
||||
**Priority values:** 0=None, 1=Low, 3=Medium, 5=High
|
||||
|
||||
### Update Task
|
||||
```bash
|
||||
POST /ticktick/open/v1/task/{taskId}
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"id": "TASK_ID",
|
||||
"projectId": "PROJECT_ID",
|
||||
"title": "Updated title",
|
||||
"priority": 1
|
||||
}
|
||||
```
|
||||
|
||||
### Complete Task
|
||||
```bash
|
||||
POST /ticktick/open/v1/project/{projectId}/task/{taskId}/complete
|
||||
```
|
||||
|
||||
### Delete Task
|
||||
```bash
|
||||
DELETE /ticktick/open/v1/project/{projectId}/task/{taskId}
|
||||
```
|
||||
|
||||
## Task Fields
|
||||
|
||||
| Field | Type | Description |
|
||||
|-------|------|-------------|
|
||||
| `id` | string | Task ID |
|
||||
| `projectId` | string | Parent project ID |
|
||||
| `title` | string | Task title |
|
||||
| `content` | string | Task description (Markdown) |
|
||||
| `priority` | integer | 0=None, 1=Low, 3=Medium, 5=High |
|
||||
| `status` | integer | 0=Active, 2=Completed |
|
||||
| `dueDate` | string | ISO 8601 format |
|
||||
| `startDate` | string | ISO 8601 format |
|
||||
| `isAllDay` | boolean | All-day task flag |
|
||||
| `timeZone` | string | e.g., "America/Los_Angeles" |
|
||||
| `tags` | array | List of tag names |
|
||||
| `columnId` | string | Kanban column ID |
|
||||
|
||||
## Notes
|
||||
|
||||
- The Open API provides access to tasks and projects only
|
||||
- Habits, focus/pomodoro, and tags endpoints are not available through the Open API
|
||||
- Task `status` values: 0 = Active, 2 = Completed
|
||||
- Dates use ISO 8601 format with timezone offset (e.g., `2026-02-15T10:00:00+0000`)
|
||||
- The `columns` field in project data is used for Kanban board columns
|
||||
|
||||
## Resources
|
||||
|
||||
- [TickTick Developer Portal](https://developer.ticktick.com/)
|
||||
- [TickTick Help Center](https://help.ticktick.com/)
|
||||
Reference in New Issue
Block a user