Öğrenci aktarımı

Öğrenci oluşturma, güncelleme ve şube değişikliği.

Tek kayıt

POST/management/users/transfer/learner/from-external-client

En yaygın durum: bir öğrenci, bir sezon, bir şube.

İstek gövdesi
{
  "firstName": "Ayşe",
  "lastName": "Yılmaz",
  "identityNumber": "12345678901",
  "dateOfBirth": 1104537600000,
  "email": null,
  "phoneNumber": null,
  "gender": "FEMALE",
  "enrollmentList": [
    {
      "seasonId": <SEASON_ID>,
      "gradeName": "9",
      "gradeLevel": 9,
      "branchName": "9-A",
      "curriculumType": "MEB",
      "coterieType": "MATHEMATICS",
      "identifier": "OKUL-STD-88421"
    }
  ]
}

Aynı sezonda iki şube

Öğrencinin sınıfı 9-A, yabancı dil grubu 9-ENG olsun:

İstek gövdesi
{
  "firstName": "Mehmet",
  "lastName": "Kaya",
  "identityNumber": "98765432109",
  "email": null,
  "phoneNumber": null,
  "enrollmentList": [
    {
      "seasonId": <SEASON_ID>, "gradeName": "9", "gradeLevel": 9, "branchName": "9-A",
      "curriculumType": "MEB", "coterieType": "MATHEMATICS",
      "identifier": "OKUL-STD-88422-A"
    },
    {
      "seasonId": <SEASON_ID>, "gradeName": "9", "gradeLevel": 9, "branchName": "9-ENG",
      "curriculumType": "MEB", "coterieType": "ENGLISH",
      "identifier": "OKUL-STD-88422-ENG"
    }
  ]
}

Aynı sezonun tekrar edilmesi normaldir ve kabul edilir. Yalnızca aynı seasonId + aynı branchName ikilisinin iki kez gönderilmesi reddedilir (duplicateEnrollmentInEnrollmentList).

Şube değişikliği

Öğrenci 9-A'dan 9-B'ye geçtiyse, yeni listeyi gönderin:

Yeni liste
"enrollmentList": [
  { "seasonId": <SEASON_ID>, "gradeName": "9", "gradeLevel": 9, "branchName": "9-B",
    "curriculumType": "MEB", "coterieType": "MATHEMATICS", "identifier": "OKUL-STD-88421" }
]

Listede olmayan kayıt silinir — ama yalnızca aynı sezonda

Gönderdiğiniz listede yer almayan ve aynı sezona ait eski kayıtlar kaldırılır: 9-A kaydı silinir, 9-B eklenir. Listede geçmeyen diğer sezonlara ait kayıtlara dokunulmaz — geçmiş yıl kayıtları korunur.

Eski (deprecated) biçim

Aşağıdaki biçim hâlâ çalışır, ancak kaldırılacaktır:

Kullanımdan kalkacak
{ "firstName": "...", "lastName": "...", "enrollment": { "seasonId": <SEASON_ID>, "...": "..." } }

enrollmentList ve enrollment birlikte gönderilirse enrollmentList geçerli olur.

Temmuz 2026 değişikliklerine bakın →