스케줄 자동 생성 | Fit-Ting API Docs

import requests
url = "https://host.com/dev/schedules/generation/generate/"
payload = { "week_start_date": "2024-06-02" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "generation_id": "a3f1c9e2-4b7d-4f8a-9c3e-2d5b7f6a8e9c",
  "trainer_id": "d9f8b7a6-3c2e-4d1f-8a9b-7e6c5d4f3a2b",
  "week_start_date": "2024-06-02",
  "status": "preview",
  "scheduled_sessions": [
    {
      "session_id": "b7e3f1a9-6c4d-4e2f-8a1b-9d7c5e3f2a1b",
      "member_id": "c1d2e3f4-5678-90ab-cdef-1234567890ab",
      "member_name": "John Doe",
      "date": "2024-06-03",
      "weekday": "Monday",
      "start_time": "09:00",
      "end_time": "10:00",
      "duration_minutes": 60,
      "is_fixed": true,
      "fulfillment": {
        "status": "scheduled",
        "scheduled": 3,
        "target": 3
      }
    }
  ],
  "conflicts": [
    {
      "member_id": "e4f5a6b7-c8d9-0e1f-2a3b-4c5d6e7f8a9b",
      "member_name": "Jane Smith",
      "reason": "Insufficient availability",
      "reason_detail": "Member's available times do not match trainer's schedule",
      "target_sessions": 4,
      "scheduled_sessions": 2,
      "alternative_slots": [
        {
          "date": "2024-06-05",
          "weekday": "Wednesday",
          "start_time": "14:00",
          "end_time": "15:00"
        },
        {
          "date": "2024-06-06",
          "weekday": "Thursday",
          "start_time": "10:00",
          "end_time": "11:00"
        }
      ],
      "is_resolved": true,
      "resolution": {
        "action": "Rescheduled to alternative slots",
        "assigned_slots": [
          {
            "date": "2024-06-05",
            "weekday": "Wednesday",
            "start_time": "14:00",
            "end_time": "15:00"
          }
        ],
        "resolved_at": "2024-06-02T09:30:00Z"
      }
    }
  ],
  "summary": {
    "total_members": 10,
    "fully_scheduled": 7,
    "partially_scheduled": 2,
    "unscheduled": 1,
    "total_sessions": 25,
    "conflicts_count": 3
  },
  "algorithm_metadata": {
    "execution_time_ms": 350,
    "tiers_applied": [
      "availability_check",
      "fixed_schedule_priority",
      "conflict_resolution",
      "optimization",
      "final_validation"
    ],
    "members_processed": 10
  },
  "expires_at": "2024-06-02T10:30:00Z",
  "created_at": "2024-06-02T09:30:00Z",
  "dry_run": false
}

5-Tier 휴리스틱 알고리즘을 사용하여 주간 스케줄을 자동 생성합니다.

트레이너의 가용성 및 회원 가용성을 기반으로 최적의 스케줄 생성
고정 스케줄이 우선 배정됨
미리보기 상태로 생성되며 1시간 후 만료
확정 전까지 수정 가능

5-Tier 휴리스틱 알고리즘을 사용하여 주간 스케줄을 자동 생성합니다. - 트레이너의 가용성 및 회원 가용성을 기반으로 최적의 스케줄 생성 - 고정 스케줄이 우선 배정됨 - 미리보기 상태로 생성되며 1시간 후 만료 - 확정 전까지 수정 가능

Authentication

AuthorizationBearer

Send a JWT access token with the Authorization header as Bearer <token>.

Request

This endpoint expects an object.

week_start_datedateRequired

trainer_time_offlist of objects or nullOptional

member_idslist of strings or nullOptional

dry_runbooleanOptionalDefaults to false

Response

스케줄 생성 성공 (미리보기)

generation_idstring or nullformat: "uuid"

trainer_idstringformat: "uuid"

week_start_datedate or null

statusstring or null

scheduled_sessionslist of objects

conflictslist of objects

summaryobject

생성 요약 응답 Serializer

algorithm_metadataobject or null

알고리즘 메타데이터 응답 Serializer

expires_atdatetime or null

created_atdatetime or null

dry_runbooleanDefaults to false

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error