Page History: Web API

Compare Page Revisions



« Older Revision - Back to Page History - Newer Revision »


Page Revision: 22.04.2015. 12:30:PM



Korištenje eVisitor Web API funkcionalnosti

Sučelje je izvedeno kao REST service (root URI: http://eVisitor/Rest/Htz). Kroz eVisitor Web API sučelje moguće je izvršiti sve operacije koje su dostupne kroz web sučelje same eVisitor aplikacije, pri čemu vrijede ista sigurnosna i poslovna pravila. Primjeri korištenja biti će prikazani u C# programskom jeziku koristeći RestSharp REST klijent.

Prijava (login)

Da bi pristup API-ju bio dozvoljen potrebno se prijaviti (login) u sustav koristeći Authentication service API (URI: http://eVisitor/Resources/AspNetFormsAuth/Authentication/), koji implementira slijedeće metode:

Login

  • Interface: (string UserName, string Password, bool PersistCookie) -> bool
  • Primjer request data: {"UserName":"myusername","Password":"mypassword","PersistCookie":false}
  • Odgovor je true pri uspješnom loginu, inače false. Pri uspješnom loginu odgvor servera sadrži i standardni authentication cookie koji se mora slati prilikom svakog poziva API REST servisa.

Logout

  • Nema nikakvih parametara, potrebno je proslijediti standardni authentication cookie. Odgovor je prazan.

Primjer prijave na sustav

Primjer se nalazi u prilogu Htz.eVisitor.WebApi.Test.zip, u datoteci Authentication.cs

Dostupne metode

Prijava turista

  • Resource: PrijavaTurista
  • Interface: (string xml, bool prijavi)
  • Odgovor je prazan u slučaju uspješne prijave, inače sadrži validacijsku grešku zbog koje prijava nije uspjela.
  • Opis sadržaja xml datoteke:
    • Objekt - šifra objekta u koji se turist prijavljuje
    • BoravakOd - datum od kojeg turist boravi u objektu (format: YYYYMMDD, primjer 20150413)
    • VrijemeBoravakOd - vrijeme od kojeg turist boravi u objektu (format: hh:mm, primjer 09:42)
    • PredvidjeniBoravakDo- datum do kojeg turist predviđa boraviti u objektu (format: YYYYMMDD, primjer 20150413)
    • VrijemePredvidjeniBoravakDo- vrijeme do kojeg turist predviđa boraviti u objektu (format: hh:mm, primjer 09:42)
    • VrstaIsprave - šifra vrste isprave kojom turist potvrđuje identitet
    • BrojISprave - broj isprave kojom turist potvrđuje identitet
    • TuristIme - ime turista
    • TuristSrednjeIme - srednje ime turista (opcionalno)
    • TuristPrezime - prezime turista
    • Spol - ženski/muški
    • DrzavaRodjenja - troslojna šifra države rođenja (npr. HRV za Hrvatsku ili DEU za Njemačku)
    • GradRodjenja - naziv grada rođenja, ukoliko je država rođenja Hrvatska onda naziv grada rođenja mora biti iz šifrarnika gradova Republike Hrvatske koji je dio eVisitor sustava
    • Drzavljanstvo - troslojna šifra države čije državljanstvo ima turist (npr. HRV za Hrvatsku ili DEU za Njemačku)