Page History: Web API
Compare Page Revisions
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)