aztu-api v1.5.0

AzTU API

API written for retrieving student data from Electronic Education Management System of AzTU using student ID and password.

Instructions for use

To install the project, type in terminal:

npm install aztu-api

You must log in before making queries.

import AzTU from 'aztu-api';

const user = { UserId: 'Username', Password: 'Password' }; // The student's information is entered

const aztu = new AzTU(user);
await aztu.login();

Code Usages

To get the student's information:

// Code
await aztu.studentInfo();

// Response
{
  student: {
    'Təhsil növü': 'Dövlət sifarişli',
    'İngilis dili adı': '',
    'Təhsil forması': 'Əyani',
    'Bölməsi': 'Azərbaycan dili',
    'Fakültənin adı': 'İnformasiya texnologiyaları  və telekommunikasiya',
    'Kafedranın adı': 'Mühəndis riyaziyyatı və süni intelekt',
    'İxtisas adı': 'Kompüter elmləri',
    'İxtisaslaşma': '',
    Kurs: 'III kurs',
    Statusu: 'təhsil alir',
    'Orta məktəb': '',
    'Orta məktəbi bitirdiyi tarix': '',
    'Qəbul olma tarixi': '20220915',
    'Bitirdiyi tarix': ''
  },
  personal: {
    'Şəxsiyyət vəsiqəsinin seriya və nömrəsi': '*******',
    Ad: 'AMİN',
    Soyad: 'BAĞIYEV',
    'Ata adı': 'İSLAM',
    Cinsi: 'Kişi',
    Telefon: '',
    'Ünvanı': '',
    'Mobil telefon': '994708143593',
    'Doğum tarixi': ''
  },
  exam: {
    'Telebe ID (Username)': '202206401',
    'Şifahi İmtahan parolu': '104602202',
    'Test İmtahan parolu': '80146828'
  }
}

To get courses in which the student is enrolled in the current semester:

// Code
await aztu.lectures();

// Response
[
  {
    'Fənn': 'Bulud texnologiyalarına giriş',
    'sərbəst iş(10)': '0',
    'Məşğələ(30)': '0',
    'Davamiyyət': '10',
    Toplam: '10'
  },
  {
    'Fənn': 'MS Excel ilə verilənlərin analizi',
    'sərbəst iş(10)': '0',
    'Məşğələ(30)': '0',
    'Davamiyyət': '10',
    Toplam: '10'
  },
  {
    'Fənn': 'Mülki müdafiə',
    'sərbəst iş(10)': '0',
    'Məşğələ(30)': '0',
    'Davamiyyət': '10',
    Toplam: '10'
  },
  {
    'Fənn': 'Optimallaşdırma üsulları',
    'sərbəst iş(10)': '0',
    'Məşğələ(30)': '0',
    'Davamiyyət': '10',
    Toplam: '10'
  },
  {
    'Fənn': 'Python-la maşın öyrənməsi',
    'sərbəst iş(10)': '0',
    'Məşğələ(30)': '0',
    'Davamiyyət': '10',
    Toplam: '10'
  },
  {
    'Fənn': 'Süni intellekt',
    'sərbəst iş(10)': '0',
    'Məşğələ(30)': '0',
    'Davamiyyət': '10',
    Toplam: '10'
  }
]

To get the student's transcript:

await aztu.transcript();

{
  semesters: {
    '2025/yaz': {
      'Fənnlər': [Array],
      'Il / semester': '2025/yaz',
      'Ümumi fənnlər': '6',
      'Dinlənmiş fənnlər': '0',
      'Umumi kredit': '30',
      'Alınmış kredit': '0',
      'Yekun orta bal': '0'
    },
    '2024/payiz': {
      'Fənnlər': [Array],
      'Il / semester': '2024/payiz',
      'Ümumi fənnlər': '6',
      'Dinlənmiş fənnlər': '1',
      'Umumi kredit': '30',
      'Alınmış kredit': '3',
      'Yekun orta bal': '136.3'
    },
    '2024/yaz': {
      'Fənnlər': [Array],
      'Il / semester': '2024/yaz',
      'Ümumi fənnlər': '6',
      'Dinlənmiş fənnlər': '6',
      'Umumi kredit': '30',
      'Alınmış kredit': '30',
      'Yekun orta bal': '67.2'
    },
    '2023/payiz': {
      'Fənnlər': [Array],
      'Il / semester': '2023/payiz',
      'Ümumi fənnlər': '6',
      'Dinlənmiş fənnlər': '6',
      'Umumi kredit': '30',
      'Alınmış kredit': '30',
      'Yekun orta bal': '79'
    },
    '2023/yaz': {
      'Fənnlər': [Array],
      'Il / semester': '2023/yaz',
      'Ümumi fənnlər': '6',
      'Dinlənmiş fənnlər': '6',
      'Umumi kredit': '30',
      'Alınmış kredit': '30',
      'Yekun orta bal': '84.3'
    },
    '2022/payiz': {
      'Fənnlər': [Array],
      'Il / semester': '2022/payiz',
      'Ümumi fənnlər': '6',
      'Dinlənmiş fənnlər': '6',
      'Umumi kredit': '30',
      'Alınmış kredit': '30',
      'Yekun orta bal': '77.9'
    }
  },
  'Fakültə / Kafedra': 'İnformasiya texnologiyaları  və telekommunikasiya  / Mühəndis riyaziyyatı və süni intelekt',
  'İdentifikator': '202206401',
  'Adı': 'AMİN',
  Status: 'təhsil alir',
  'Ümumi fənnlər': '36',
  'Dinlənmiş fənnlər': '25',
  'Umumi kredit': '180',
  'Alınmış kredit': '123',
  'Yekun orta bal': '78.5447'
}

License

See the LICENSE file for license rights and restrictions. (ISC)

Other languages

🇦🇿 Azerbaijani