Kurumlar için · Web API v1

Öğrencilerinizi ve eğitmenlerinizi kendi sisteminizden ekleyin

Üniversiteler, fakülteler ve hastaneler öğrenci bilgi sisteminden (ÖBS) ya da personel sisteminden öğrenci, eğitmen ve ders kayıtlarını AIRADAR e-öğrenme merkezine — Canvas LMS ve portal birlikte — otomatik aktarabilir. Aynı işlemleri kod yazmadan Excel ile toplu ekleme üzerinden de yapabilirsiniz.

Kurum hesabı oluştur OpenAPI şeması

Nasıl başlanır?

1Kurum hesabıKurum olarak kaydolun. .edu.tr / .gov.tr alan adlarıyla anında, diğerleri 1 iş günü içinde doğrulanır.
2PaketWeb API aktif paketi olan, doğrulanmış kurumlara açıktır. Öğrenci / eğitmen / ders sınırları paketinizden gelir.
3API anahtarıKurum paneli → Excel ile toplu ekleme → Web API anahtarları. Yetkileri, izinli IP'leri ve süreyi seçin; anahtar bir kez gösterilir.
4EntegrasyonAşağıdaki uç noktalarla kişileri ekleyin, derslere kaydedin, toplu işlerin raporunu izleyin.

Güvenlik ve kişisel veriler (KVKK)

Erişim
  • Her istek Authorization: Bearer mdr_… başlığıyla; anahtarın yalnız özeti saklanır, iptal edilen anahtar hemen çalışmaz.
  • Anahtar yalnız kendi kurumunuzun kayıtlarına erişir; başka kurumun verisi görünmez, değiştirilemez.
  • Yetki kapsamları: people:read (Kişileri listeleme), people:write (Kişi ekleme ve durum değiştirme), enrollments:write (Derse kayıt), courses:read (Dersleri ve birimleri listeleme).
  • İzinli IP listesi, dakikada 120 / günde 20.000 istek, toplu işlemde 500 kayıt sınırı. Her yazma işlemi denetim kaydına geçer.
Kişisel veriler
  • Yalnız gerekli alanlar: ad, soyad, e-posta, rol; isteğe bağlı kurum numaranız ve birim. T.C. kimlik numarası gerekmez.
  • Parola göndermezseniz güçlü geçici parola üretilir, yanıtta bir kez döner; bizde açık hali saklanmaz.
  • Toplu işlerin girdi satırları iş bitince silinir, raporlarda e-postalar maskelenir; iş kayıtları 7 günde silinir.
  • Veriler Türkiye'deki sunucularımızda, Canvas LMS ile birlikte kurumunuzun ayrı hesabında tutulur.
  • Veri işleme: kurumunuz veri sorumlusu, AR ARGE Teknoloji A.Ş. veri işleyendir. Veriler yalnız e-öğrenme hizmetini sunmak için işlenir, üçüncü kişilere aktarılmaz, pazarlamada kullanılmaz; kurum isteği ya da sözleşme sonunda silinir veya iade edilir. API anahtarı oluşturulurken bu koşullar kabul edilir ve kaydedilir.

Hızlı başlangıç

Anahtarınızı doğrulayın ve paket sınırlarınızı görün:

curl -H "Authorization: Bearer $AIRADAR_KEY" https://arsolution.com/api/v1/me

Bir öğrenci ekleyin (aynı e-posta tekrar gönderilirse 200 ve "status": "exists" döner, yeniden denemek güvenlidir):

curl -X POST https://arsolution.com/api/v1/people \
  -H "Authorization: Bearer $AIRADAR_KEY" -H "Content-Type: application/json" \
  -d '{"email":"ayse.yilmaz@universite.edu.tr","first_name":"Ayşe","last_name":"Yılmaz",
       "role":"student","sis_id":"2026001","department":"Tıp Fakültesi"}'

Derse kaydedin:

curl -X POST https://arsolution.com/api/v1/enrollments \
  -H "Authorization: Bearer $AIRADAR_KEY" -H "Content-Type: application/json" \
  -d '{"course":"Anatomi 1","user":"2026001","role":"student"}'

Toplu ekleme (en fazla 500 kişi) — arka planda işlenir, iş numarasıyla izlenir:

curl -X POST https://arsolution.com/api/v1/people/batch -H "Authorization: Bearer $AIRADAR_KEY" \
  -H "Content-Type: application/json" -d '{"people":[{"email":"...","first_name":"...","last_name":"..."}]}'
# → 202 {"data":{"job_id":"...","status":"queued","total":250}}
curl -H "Authorization: Bearer $AIRADAR_KEY" https://arsolution.com/api/v1/jobs/JOB_ID
curl -X POST -H "Authorization: Bearer $AIRADAR_KEY" https://arsolution.com/api/v1/jobs/JOB_ID/credentials   # geçici parolalar, bir kez

Uç noktalar

YöntemYolYetkiAçıklama
GET/api/v1/me—Anahtarın kurumu, yetkileri, paket sınırları ve kullanım
GET/api/v1/departmentscourses:readKurumunuzun alt birimleri (fakülte, bölüm)
GET/api/v1/coursescourses:readDersleriniz (sayfalı: ?page=&per_page=)
GET/api/v1/peoplepeople:readKişileriniz (?role=student|teacher&updated_since=&page=)
GET/api/v1/people/{ref}people:readTek kişi (e-posta, kurum numarası ya da id)
POST/api/v1/peoplepeople:writeÖğrenci / eğitmen ekle (varsa 200 döner, yeniden denemek güvenli)
PATCH/api/v1/people/{ref}people:writeDurum: active | passive (pasif kişi giriş yapamaz)
POST/api/v1/people/batchpeople:writeEn fazla 500 kişi; arka planda işlenir (202 + iş no)
POST/api/v1/enrollmentsenrollments:writeKişiyi derse kaydet (öğrenci / eğitmen, aktif / pasif)
POST/api/v1/enrollments/batchenrollments:writeEn fazla 500 ders kaydı; arka planda işlenir
GET/api/v1/jobs/{id}—Toplu işin durumu ve satır raporu
POST/api/v1/jobs/{id}/credentialspeople:writeToplu işte üretilen geçici parolalar (yalnız bir kez)

Yanıtlar ve hatalar

Başarılı yanıtlar {"data": …}, hatalar {"error": {"code", "message"}} biçimindedir. Başlıca kodlar: 401 anahtar yok / geçersiz, 403 yetki, IP, paket ya da kurum doğrulaması, 404 kayıt yok, 409 e-posta başka bir hesapta, 413 toplu işlem 500'den büyük, 429 hız sınırı (Retry-After başlığına uyun). Paket sınırı dolduğunda kişi ekleme 403 limit döner.

Kod yazmadan: Excel ile toplu ekleme

Kurum paneli → Excel ile toplu ekleme. Şablonları indirin, doldurun, yükleyin; ilerlemeyi ve satır satır raporu aynı sayfada görün. Başlıklar Türkçe ya da İngilizce olabilir (ad, soyad, e_posta, ogrenci_no, bolum …). Canvas SIS CSV dosyalarınızı (users.csv, enrollments.csv) da olduğu gibi yükleyebilirsiniz. En fazla 5.000 satır / 5 MB.

Kişi şablonu Ders kaydı şablonu Durum şablonu

Kurum içi yetkililer

Kurum yöneticisi; öğrenci işleri, dekanlık ve bölüm başkanlığı için ayrı yetkililer tanımlayabilir. Her yetkili yalnız kendi biriminde ve kendi yetkisi kadar işlem yapar (ör. bölüm başkanı kendi bölümünün eğitmen ve ders kayıtlarını yönetir, dekan fakültesini salt okunur izler). Aynı sınırlar Web API anahtarları için de geçerlidir.

Destek

Entegrasyon için teknik destek: iletişim formu. Sürüm notları ve değişiklikler bu sayfada duyurulur; v1 uç noktaları geriye dönük uyumlu tutulur.