Vitamin API

Vitaminlar va qo'shimchalar kursini boshqarish. Bolaga berilayotgan vitaminlar monitoringi.

Asosiy URL: /api/client/vitaminsHeaderlar: Barcha so'rovlarda Authorization: Bearer <token> va x-child-id: <child_id> bo'lishi shart.

1. Tavsiya etilgan vitaminlar ro'yxati

Bolaning yoshidan kelib chiqib tavsiya etiladigan vitaminlar katalogi (Faqat axborot uchun).

  • URL: /recommendations
  • Metod: GET

Javob (Response): (Array qaytadi)

[
  {
    "id": "vit-uuid-1",
    "name": "Vitamin D3",
    "code": "VIT-D3",
    "category": "Immunitet",
    "description": "Suyaklarni mustahkamlash...",
    "benefits": ["Immunitetni oshiradi", "Suyak o'sishiga yordam beradi"],
    "minAgeDays": 0,
    "maxAgeDays": 365,
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  }
]

2. Yangi vitamin kursini boshlash

  • URL: /courses
  • Metod: POST

So'rov tanasi (Request Body):

{
  "vitaminName": "Vitamin D3 (Aquadetrim)",
  "dosage": "2 tomchi (800 IU)",
  "startDate": "2026-03-28",
  "durationDays": 90,
  "reminderTime": "09:00" // Agar eslatma kerak bo'lsa (Ixtiyoriy)
}

Javob (Response):

{
  "id": "course-uuid-123",
  "childId": "child-uuid",
  "vitaminName": "Vitamin D3 (Aquadetrim)",
  "dosage": "2 tomchi (800 IU)",
  "startDate": "2026-03-28T00:00:00.000Z",
  "durationDays": 90,
  "reminderTime": "09:00",
  "isActive": true,
  "createdAt": "2026-03-28T10:00:00.000Z",
  "updatedAt": "2026-03-28T10:00:00.000Z"
}

3. Faol vitamin kurslarini olish

Hozirgi vaqtda bola ichayotgan vitaminlar statistikasi holatida keladi.

  • URL: /active
  • Metod: GET

Javob (Response):

[
  {
    "id": "course-uuid-123",
    "childId": "child-uuid",
    "vitaminName": "Vitamin D3 (Aquadetrim)",
    "dosage": "2 tomchi (800 IU)",
    "startDate": "2026-03-28T00:00:00.000Z",
    "durationDays": 90,
    "reminderTime": "09:00",
    "isActive": true,
    "createdAt": "2026-03-28T10:00:00.000Z",
    "updatedAt": "2026-03-28T10:00:00.000Z"
  }
]

4. Vitamin qabul qilinganini belgilash

  • URL: /courses/:courseId/log
  • Metod: POST
  • Query parametrlar: date (Ixtiyoriy, masalan: ?date=2026-03-28. Agar berilmasa bugungi sana asosida belgilaydi)
  • Parametr: courseId - vitamin kursi id raqami (masalan: course-uuid-123)

So'rov tanasi (Request Body): (Bo'sh)

{}

Javob (Response): Odatda tasdiqlovchi status yoki yaratilgan intake obyekti qaytadi.

{
  "id": "intake-uuid-abc",
  "courseId": "course-uuid-123",
  "date": "2026-03-28T00:00:00.000Z",
  "taken": true
}