Pomodoro Sessions

セッション一覧を取得

GET/sessionsv1

認証した利用者のPomodoroセッションを新しい順で返します。

クエリパラメータ

名前	型	必須	説明
limit	integer	いいえ	取得件数（1〜100、既定値20）
cursor	string	いいえ	次ページ取得用カーソル

curl "https://ffpf-api-production.sparklingstadt.workers.dev/v1/sessions?limit=20" \
  -H "Authorization: Bearer $FFPF_API_TOKEN"

{
  "data": [
    {
      "id": "ses_01J5ABCDEF",
      "started_at": "2026-08-15T03:30:00Z",
      "ended_at": "2026-08-15T03:55:00Z",
      "duration_minutes": 25,
      "status": "completed"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

セッションを作成

POST/sessionsv1

完了したPomodoroセッションを記録します。sessions:write スコープが必要です。

リクエストボディ

名前	型	必須	説明
started_at	string	はい	開始日時（ISO 8601）
ended_at	string	はい	終了日時（ISO 8601）
note	string	いいえ	500文字以内のメモ

curl -X POST https://ffpf-api-production.sparklingstadt.workers.dev/v1/sessions \
  -H "Authorization: Bearer $FFPF_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "started_at": "2026-08-15T03:30:00Z",
    "ended_at": "2026-08-15T03:55:00Z",
    "note": "中国語の復習"
  }'

成功時は 201 Created と作成したセッションを返します。