写入习惯打卡

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

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

请求

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

请求参数

`habitId`

pathstring必填

习惯 ID

habit-1

Body 参数

HabitCheckInUpsert必填

Content-Type: application/json

{
  "stamp": 20260407,
  "value": 1,
  "goal": 1
}

响应

`200`

OpenHabitCheckinapplication/json

已更新的打卡文档

字段: idhabitIdcreatedTimemodifiedTimeetagyearcheckins

`201`

unknown

已创建，无响应内容

`401`

unknown

未授权

`403`

unknown

禁止访问

`404`

unknown

未找到

{
  "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
    }
  ]
}