Temmuz 2026 değişiklikleri

Yalnızca Temmuz 2026'dan önce kurulmuş entegrasyonlar için geçerlidir. Entegrasyonunuzu yeni kuruyorsanız bu sayfayı atlayabilirsiniz.

Token artık URL'in # (fragment) kısmında dönüyor

Bu madde kod değişikliği gerektirebilir

Diğer maddeler geriye dönük uyumludur.

Önceden redirectUrl şu biçimdeydi:

ESKİ

https://app.catchupper.com/...?accessToken=...&refreshToken=...

Artık:

YENİ

https://app.catchupper.com/login/with-external-client#accessToken=...&refreshToken=...

Sebep: # sonrası kısım tarayıcı tarafından sunucuya gönderilmez. Böylece token'lar ara sunucu/erişim kayıtlarına, proxy loglarına ve Referer başlığına düşmez.

Sizi etkileyen durum: redirectUrl'ü olduğu gibi kullanıcıya yönlendiriyorsanız hiçbir şey yapmanız gerekmez. Ancak URL'i ayrıştırıp token'ı kendiniz okuyorsanız, artık query string yerine fragment'ten okumalısınız. Geçiş kolaylığı için query string biçimi bir sürüm daha desteklenmeye devam edecek, sonra kaldırılacaktır.

Birden fazla kayıt gönderebilirsiniz: enrollmentList

Eskiden tek bir enrollment nesnesi gönderiliyordu. Artık liste gönderilebiliyor:

Bir öğrenci aynı sezonda birden fazla şubede olabilir (örn. sınıfı 9-A, yabancı dil grubu 9-ENG).
Bir öğretmen aynı marka içinde birden fazla okulda/sezonda çalışabilir.
Bir yönetici birden fazla sezonun yöneticisi olabilir.

Eski tek-nesne biçimi (enrollment) çalışmaya devam ediyor ancak kullanımdan kaldırılacak. Yeni geliştirmelerde enrollmentList kullanın.

Personel için staffMode alanı eklendi

Öğretmen ile yönetici artık açıkça ayrılıyor: "staffMode": "TEACHER" veya "MANAGER". Alan gönderilmezse TEACHER kabul edilir, bu yüzden mevcut entegrasyonunuz bozulmaz.

Marka (brand) bazlı yetki sınırı getirildi

İstemciniz artık yalnızca kendi markanıza ait sezonlara aktarım yapabilir. Yanlış bir seasonId sessizce kabul edilmek yerine reddedilir.