Projektas

Aplikacijų programavimo sąsaja API pavadinimu – Lietuvos krepšinio komandos

„Lietuvos krepšinio komandos“ API dokumentacija
Apie projektą

API (Aplication programming interface) – tai sąsaja tarp programinių įrangų, kurios gali siųsti viena kitai, duomenis, komandas. Kurdamas šią aplikaciją naudojau Node.js kuris suteikia galimybe kurti svetainės iš serverio pusės (toliau backend), kartu taip pat naudojau „Express“ ir „EJS“ npm (Node package manager) modulius.

Naudojami NPM (Node Package Manager) moduliai
Naudojami NPM (Node Package Manager) moduliai

„Express“ modulis, kuris supaprastina serverio Node.js funkcionalumą, tai yra greičiau ir efektyviau, naudojant mažiau kodo eilučių gaunamas tas pats rezultatas.

Node.js prieš ir po naudojantis „Express“ moduliu
Node.js prieš ir po naudojantis „Express“ moduliu

„EJS“ modulis leidžia dinamiškai atvaizduoti html puslapius interneto naršyklėje. Leidžia įterpti Javascript ir atvaizduoti tai kliento pusėje (toliau frontend). Būtent šio modulio pagalba buvo parašytas lokalizacijos failas dviem kalbomis lietuviškai ir angliškai. Vartotojui pasirinkus norimą kalbą, ši yra atvaizduojama html puslapio pavidalu.

„EJS“ atvaizduoja lokalizacijos faile esančius duomenis
„EJS“ atvaizduoja lokalizacijos faile esančius duomenis

Šis API turi duomenis apie Lietuvos krepšinio komandas, žaidėjus, trenerius, poziciją ir sudėtį. Šie duomenys yra saugomi json faile, kurį reikia importuoti į šią aplikaciją norint juos pasiekti ir jais manipuliuoti.

Lietuvos krepšinio komandos duomenys json faile
Lietuvos krepšinio komandos duomenys json faile
Lokalizacijos duomenis lietuvių ir anglų kalba json faile
Lokalizacijos duomenis lietuvių ir anglų kalba json faile
Importuoti json failai norint juos pasiekti Node.js platformoje
Importuoti json failai norint juos pasiekti Node.js platformoje
Apdorojami duomenys ir išsiunčiami į svetainę
Apdorojami duomenys ir išsiunčiami į svetainę

Backend pagalba buvo padaryta taip, kad ši API aplikacija išsiūstų tik tuos duomenis, kurie yra apie komandą, kuri yra pasirinkta pagal jos identifikacijos numerį. (Visi komandų identifikacijos numeriai yra aprašyti dokumentacijoje).

Gaunami duomenys pagal komandos identifikacijos numerį, pavyzdys
Gaunami duomenys pagal komandos identifikacijos numerį, pavyzdys

Konkretaus žaidėjo/trenerio ieškojimas šiuose duomenyse buvo realizuotas taip, kad visi žaidėjai/treneriai iš visų komandų buvo įdėti į vieną  grupę, ir vartotojui įvedus vardą, pavardę, arba pozicija, būtų gaunami tik tie žaidėjai/treneriai kurių šie trys kriterijai sutaptu su vartotojo įvestais.

Apdorojami duomenys taip, kad visi žaidėjai ir treneriai iš skirtingų komandų atsidurtų vienoje grupėje
Apdorojami duomenys taip, kad visi žaidėjai ir treneriai iš skirtingų komandų atsidurtų vienoje grupėje
Gaunami duomenys pagal vartotojo įvestus kriterijus
Gaunami duomenys pagal vartotojo įvestus kriterijus
Pavyzdys gaunamų duomenų pagal įvestus kriterijus
Pavyzdys gaunamų duomenų pagal įvestus kriterijus

Galiausiai realizuota taip, kad būtų išsiunčiami visi duomenys apie visas esančias komandas.

Išsiunčiami duomenys apie visas komandas
Išsiunčiami duomenys apie visas komandas