写入习惯打卡

为指定习惯创建或更新某个日期的打卡数值与状态。

通过 OAuth 2.0 管理滴答清单的项目、任务、评论、标签、专注记录、倒数日、习惯与打卡。

请求

operationId: upsertHabitCheckIn
服务器: https://api.dida365.com
认证: OAuth2

请求参数

`habitId`

pathstring必填

习惯 ID

habit-1

Body 参数

HabitCheckInUpsert必填

Content-Type: application/json

响应

`200`

OpenHabitCheckinapplication/json

已更新的打卡文档

字段: idhabitIdcreatedTimemodifiedTimeetagyearcheckins

`201`

unknownapplication/json

已创建，无响应内容

`401`

unknownapplication/json

未授权

`403`

unknownapplication/json

禁止访问

`404`

unknownapplication/json

未找到

{
  "habitId": "habit-1",
  "createdTime": "2026-04-07T08:00:00+0000",
  "modifiedTime": "2026-04-07T08:00:00+0000",
  "year": 2026,
  "checkins": {
    "stamp": 20260407,
    "time": "2026-04-07T08:00:00+0000",
    "opTime": "2026-04-07T08:00:00+0000",
    "value": 1,
    "goal": 1,
    "status": 0
  }
}