C# asiakasohjelman luominen OpenAPI-määrityksestä sekä sen käyttö Azuren API Managementin läpi

Abstract

Opinnäytetyön taustalla oli TietoEVRYn asiakkaan halu tehdä konseptitodistus tässä opinnäytetyössä käytettyjä teknologioita ja niiden toimintoja hyödyntäen. Tästä syystä luottamuksellinen aineisto on poistettu tästä raportista. Opinnäytetyön tavoitteena oli luoda onnistuneesti C#-ohjelmointikieltä hyödyntävä asiakasohjelma OpenAPI-määrityksestä ja sen jälkeen tehdä kutsu Azuren API Managementin läpi asiakkaan olemassa olevalle palvelimelle. Työssä avataan käytettyjä teknologioita sekä toteutetaan tavoitteen mukainen kokonaisuus. Lopuksi pohditaan työn tuloksia sekä mahdollisia jatkokehitysideoita.

Opinnäytetyön tuloksena saatiin luotua NSwagStudiolla OpenAPI-määrityksestä toimiva asiakasohjelma ja sen avulla tehtyä kutsu Azuren API Managementin läpi asiakkaan olemassa olevalle palvelimelle. Asiakasohjelman luonti OpenAPI-määrityksestä tuotti parhaimmillaan yli 30 000 koodirivin asiakasohjelman ja osoittautui näin ollen todella tehokkaaksi tavaksi luoda asiakasohjelmia.

Työtä voisi lähteä jatkokehittämään esimerkiksi selvittämällä keinoja hyödyntää Azuren API Managementin laajoja toiminnallisuuksia. Hyvä esimerkki tästä voisi olla kutsujen oikeuksien tarkistaminen API Managementin avulla sekä toiminnallisuuden toteuttaminen asiakasohjelmassa.

The basis for this bachelor's thesis was TietoEVRY’s customers wish to do a proof of concept for the technologies and functionality used in this thesis. For that reason, all confidential material has been removed from this report.

The goal for this thesis was to generate a functioning client that uses C# programming language from OpenAPI specification and to use it to make a successful request through Azure API Management into the existing backend of the customer. This thesis introduces the used technologies and implements the totality according to the goal. At the end of the thesis there is section where results and possible future developments are reflected.

As a result of this thesis a working client using C# programming language was generated from OpenAPI specification using NSwagStudio and with it a successful request was made through Azure API Management to the existing backend of the customer. The client generating from OpenAPI specification produced at best over 30 000 rows of code and was shown to be extremely efficient way to produce clients.